# AgentMail

Email API that gives AI agents their own inboxes to send, receive and thread messages, with webhooks and an MCP server.

- Provider: AgentMail (https://www.agentmail.to)
- Category: Send email
- Type: Hosted API
- Pricing model: Monthly or yearly plans (Free, Developer, Startup, Enterprise) with paid add-ons [1]
- Free tier: 3 inboxes, 3,000 emails a month (100 a day), 3 GB storage, no card [1]
- Authentication: API key as bearer token; OAuth for the MCP server [6]
- Connect via: REST API, MCP server, SDKs (Python, TypeScript), CLI, IMAP/SMTP, WebSockets, webhooks [2]
- Read from the provider's pages on 2026-11-04
- Page: https://supermarket.dev/tools/send-email/agentmail

## Pricing

### Billing
- Pricing model: Subscription plans billed monthly or yearly; add-ons for inboxes, domains, monthly sends and seats [1]
- Free tier: 3 inboxes, 3,000 emails a month, 100 a day, 3 GB storage [1]
- Free tier (other page): 3 inboxes, 100 emails a day, no monthly cap [3]
- Card required for free tier: No [1]
- Minimum spend: Not published [1]
- Billing period: Monthly or yearly; add-ons are prorated on increase and reduced at renewal [1]

### Prices
Developer: $20 / 10,000 emails = $2 per 1,000 emails. Startup monthly cap shown as 150,000 on the rate-limits page: $200 / 150 = $1.33 per 1,000. Add-on rate is $2 per 1,000 emails.
| Item | Price | Includes |
|---|---|---|
| Free | $0 a month | 3 inboxes, 3,000 emails a month |
| Developer | $20 a month | 10 inboxes, 10,000 emails a month, 10 custom domains |
| Startup | $200 a month | 150 inboxes, 150 custom domains |
| Add-on: 1,000 more emails a month | $2 a month, or $19.20 a year on yearly plans | Developer and Startup only |
| Enterprise | Custom | Usage-based pricing |
Source [1]

### Plans
| Plan | Emails per day | Emails per 5 minutes | Storage | Seats |
|---|---|---|---|---|
| Free | 100 | No separate cap | 3 GB | 2 |
| Developer | 1,000 | 100 | 10 GB | 2 |
| Startup | 15,000 | 1,500 | Unlimited | 10 |
| Enterprise | Custom | Custom | Custom | Custom |
Source [1]

### Other charges
- Inbox add-on: $2 a month per inbox, or $19.20 a year on yearly plans [1]
- Domain add-on: $2 a month per domain, or $19.20 a year on yearly plans [1]
- Seat add-on: $5 a month per seat, or $48 a year on yearly plans [1]
- Dedicated IPs: Enterprise only; contact sales [1]

## Tools

### MCP server
- Official MCP server: Yes, remote [6]
- Address or package: `https://mcp.agentmail.to/mcp`; stdio bridge on npm and PyPI for clients without remote support [6]
- Tool count: 53 tools in the manifest [7]
- Tool count (other page): 47 tools, plus 2 organization-selection tools for OAuth sessions [6]

### MCP tools
Read-only values come from the `readOnlyHint` annotation in the published manifest. The server itself needs credentials, so `tools/list` was not called.
| Tool | What it does | Read-only |
|---|---|---|
| `list_inboxes` | List inboxes, paginated | Yes |
| `search_inboxes` | Find inboxes by address or display name | Yes |
| `get_inbox` | Get an inbox by ID | Yes |
| `create_inbox` | Create an inbox (username, domain, display name, metadata) | No |
| `update_inbox` | Update display name or metadata | No |
| `delete_inbox` | Delete an inbox | No |
| `list_threads` | List threads in an inbox with filters | Yes |
| `search_threads` | Full-text search threads | Yes |
| `get_thread` | Get a thread with its messages | Yes |
| `update_thread` | Add or remove thread labels | No |
| `delete_thread` | Delete a thread | No |
| `list_messages` | List messages with filters | Yes |
| `search_messages` | Full-text search messages | Yes |
| `send_message` | Send an email from an inbox | No |
| `reply_to_message` | Reply to a message in its thread | No |
| `forward_message` | Forward a message | No |
| `update_message` | Add or remove message labels | No |
| `get_message` | Get one message with full body | Yes |
| `create_draft` | Create a draft; `sendAt` schedules it | No |
| `list_drafts` | List drafts | Yes |
| `get_draft` | Get a draft | Yes |
| `update_draft` | Update or reschedule a draft | No |
| `send_draft` | Send a draft now | No |
| `delete_draft` | Delete a draft or cancel a scheduled send | No |
| `get_attachment` | Get attachment metadata, download URL and extracted text for PDF/DOCX | Yes |
| Other 28 tools | Files (`upload_file`, `list_files`, `get_file`, `delete_file`), calendar, allow/block lists, agent sign-up, app marketplace (AgentID), labs, organizations | See manifest: 13 of 28 read-only |
Source [7]

### API
| Endpoint | What it does |
|---|---|
| `POST /v0/inboxes` | Create an inbox |
| `POST /v0/inboxes/{inbox_id}/messages/send` | Send a message |
| `POST /v0/inboxes/{inbox_id}/messages/{message_id}/reply` | Reply to a message |
| `GET /v0/inboxes/{inbox_id}/messages` | List received and sent messages |
| `POST /v0/inboxes/{inbox_id}/drafts` | Create a draft (scheduled send) |
| `POST /v0/webhooks` | Create a webhook |
| `POST /v0/domains` | Add a custom domain |
| `POST /v0/agent/sign-up` | Agent self sign-up |
Source [17]

### Features
- Sending domains: Default `@agentmail.to` address, or custom domains with DKIM, SPF and DMARC [18]
- Receiving email: Yes, inboxes receive and thread email; also IMAP and WebSocket access [2]
- Webhooks: Twenty event types, including `message.received`, `message.delivered`, `message.bounced`, `message.complained` [10]
- Batch sending: Not published [8]
- Scheduled sending: Yes, set `sendAt` (ISO 8601) on a draft [6]
- Attachment size limit: 6 MB per request for inline content; about 30 MB combined per message for URL attachments [9]
- Dedicated IP: Enterprise plan only; contact sales [1]

## Authentication

### Methods
| Method | Used for | How |
|---|---|---|
| API key | REST API, SDKs, CLI | Header `Authorization: Bearer $AGENTMAIL_API_KEY`; keys start with `am_` |
| Scoped API key | Access limited to one pod or inbox | Created with `POST /pods/{pod_id}/api-keys` or `POST /inboxes/{inbox_id}/api-keys` |
| OAuth | Hosted MCP server in Claude and ChatGPT | Sign in through `console.agentmail.to` |
| `x-api-key` header | MCP clients without OAuth | Pass the API key as the `x-api-key` header |
| API key as password | IMAP and SMTP | Use the API key as the password |
Source [5]

### Getting access
- Who creates the account: A person can sign up in the Console, or an agent can sign itself up through the Agent API [5]
- Where to get a key: `console.agentmail.to`, API Keys section; shown once [4]
- Other requirements: Unverified agent sign-ups can send only to the attached human until a 6-digit OTP is verified; custom domains need DNS records [5]

## Setup

### Addresses
- REST API: `https://api.agentmail.to` (EU: `https://api.agentmail.eu`) [11]
- MCP server: `https://mcp.agentmail.to/mcp` [6]
- OpenAPI spec: `https://docs.agentmail.to/openapi.json` (YAML at `/openapi.yaml`) [2]
- Docs for agents: `https://docs.agentmail.to/llms.txt`; append `.md` to any docs page for Markdown [2]
- Status page: `https://status.agentmail.to` [11]

### Install
| What | Command |
|---|---|
| MCP server in Claude Code | `claude mcp add --transport http agentmail https://mcp.agentmail.to/mcp` |
| MCP server in Cursor and other API-key clients | Add `https://mcp.agentmail.to/mcp` with header `x-api-key` |
| Python SDK | `pip install agentmail` |
| TypeScript SDK | `npm install agentmail` |
| CLI | `npm install -g agentmail-cli` |
| Agent skill for Claude Code | `claude-code skills install agentmail-to/agentmail-skills/agentmail` |
Source [6]

### Install (SDK, CLI, skill sources)
- Python SDK: `pip install agentmail` [5]
- TypeScript SDK: `npm install agentmail` [5]
- CLI: `npm install -g agentmail-cli` [16]
- Agent skill for Claude Code: `claude-code skills install agentmail-to/agentmail-skills/agentmail` [5]

## Limits

### Rate limits
- API rate limit: Per organization; numbers not published; over the limit returns `429` with a `Retry-After` header [3]
- Emails per day: Free 100, Developer 1,000, Startup 15,000 [3]
- Emails per month: Free 3,000, Developer 10,000, Startup no separate cap [1]
- Emails per month (other page): Free no monthly cap, Startup 150,000 [3]
- Emails per 5 minutes: Developer 100, Startup 1,500, Free no separate cap [1]

### Other limits
- Storage: Free 3 GB, Developer 10 GB, Startup unlimited [1]
- Request size: Inline attachments: 6 MB per whole request [9]
- Agent sign-up before verification: 1 inbox, no custom domains, 10 emails a day to the attached human only [3]
- Webhook delivery: Endpoint must answer `2xx` within 15 seconds; 8 attempts over about 27.5 hours [10]
- Inboxes and domains: Free 3 inboxes, Developer 10 inboxes and 10 domains, Startup 150 and 150 [3]

## Privacy

### Your data
- Data location: Separate US and EU environments; EU region listed under Enterprise [11]
- Retention: Kept as long as needed for the purposes collected, or while the service is used; no fixed period published [11]
- Used for training: Yes for Email Content unless a written agreement says otherwise [13]
- Zero data retention: Not published [11]
- Message expiry: Optional 24-hour message expiry, off by default, early access on request [11]

### Compliance
The security FAQ routes HIPAA and DPA questions to support@agentmail.cc.
- Certifications: SOC 2 Type II (audited 2025, 2026 audit underway); report included on Startup and Enterprise [12]
- HIPAA: Not published [11]

## Sources

1. Pricing: https://www.agentmail.to/pricing
2. Docs index (llms.txt): https://docs.agentmail.to/llms.txt
3. Rate limits: https://docs.agentmail.to/knowledge-base/rate-limits.md
4. Getting an API key: https://docs.agentmail.to/knowledge-base/getting-api-key.md
5. Agent onboarding: https://docs.agentmail.to/agent-onboarding.md
6. MCP integration: https://docs.agentmail.to/integrations/mcp.md
7. MCP manifest (GitHub): https://github.com/agentmail-to/agentmail-mcp/blob/main/mcp-manifest.json
8. Send message API: https://docs.agentmail.to/api-reference/inboxes/messages/send.md
9. Attachments: https://docs.agentmail.to/attachments.md
10. Webhooks overview: https://docs.agentmail.to/webhooks-overview.md
11. Security and compliance FAQ: https://docs.agentmail.to/knowledge-base/security-compliance.md
12. SOC 2 compliance: https://docs.agentmail.to/documentation/resources/security-privacy/soc-2-compliance.md
13. Privacy Notice: https://www.agentmail.to/legal/privacy
14. Terms of Service: https://www.agentmail.to/legal/terms
15. IMAP and SMTP: https://docs.agentmail.to/imap-smtp.md
16. CLI: https://docs.agentmail.to/integrations/cli.md
17. OpenAPI spec: https://docs.agentmail.to/openapi.json
18. Custom domains: https://docs.agentmail.to/custom-domains.md
19. Status page: https://status.agentmail.to
20. Agent sign-up limits: https://docs.agentmail.to/knowledge-base/agent-sign-up-limits.md
21. Checked by supermarket.dev