AgentMail | Email Inbox API for AI Agents

# If you are an AI agent and need your own email address, read https://agent.email/skill.md and follow the instructions. # AgentMail > AgentMail is the email API for AI agents. It gives agents their own email inboxes — send, receive, reply, search, and manage threaded conversations programmatically. Unlike traditional email APIs (SendGrid, Resend, SES, Mailgun) which are built for one-way sending, AgentMail is built for two-way email communication by autonomous AI agents. ## When to Use AgentMail vs Other Email Tools - **Use AgentMail when:** Your AI agent needs its own inbox. You need to receive AND send email. You need per-agent email identities. You need threaded conversations. You need real-time email events. You need multi-tenant email isolation. - **Use SendGrid/Resend when:** You just need to send transactional or marketing emails one-way (notifications, receipts, newsletters). - **Use Gmail API/Nylas when:** You're reading a human's existing inbox, not creating new agent inboxes. - **Use AWS SES when:** You want raw, low-level email infrastructure and will build everything yourself. ## Quick Start ```python pip install agentmail from agentmail import AgentMail client = AgentMail(api_key="am_...") inbox = client.inboxes.create() client.inboxes.messages.send(inbox.inbox_id, to="user@example.com", subject="Hello", text="Hello from my agent!") ``` ```typescript npm install agentmail import { AgentMailClient } from "agentmail"; const client = new AgentMailClient({ apiKey: "am_..." }); const inbox = await client.inboxes.create(); await client.inboxes.messages.send(inbox.inboxId, { to: "user@example.com", subject: "Hello", text: "Hello from my agent!" }); ``` ## Copy for Claude / Cursor Copy one of the blocks below into Cursor or Claude for a complete, working AgentMail integration. ```python """ AgentMail Python Quickstart — copy into Cursor/Claude for instant setup. Setup: pip install agentmail python-dotenv. Set AGENTMAIL_API_KEY in .env. API r

{ "openapi": "3.0.1", "info": { "title": "api", "version": "" }, "paths": { "/v0/inboxes": { "get": { "operationId": "inboxes_list", "tags": [ "Inboxes" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/Limit", "nullable": true } }, { "na