e2a — email for AI agents — Claude Code MCP server
Provides dedicated email inboxes for AI agents to inspect, dispatch, and track mail threads. Useful when an agent requires its own address with human review safeguards.
claude mcp add --transport http mcp-server https://api.e2a.dev/mcpWhat e2a — email for AI agents does
The integration connects to a hosted Streamable HTTP endpoint at https://api.e2a.dev/mcp. Authentication relies on an API token sent in the Authorization: Bearer <e2a API key> header or an interactive OAuth 2.1 browser flow. Available tools depend on the credential scope: individual agent tokens unlock 21 runtime operations for inbox handling, while account tokens grant access to all 80 tools for domain configuration, suppression lists, and webhooks.
Incoming messages arrive via HMAC-signed webhooks or polling through list_messages. Agents maintain existing conversations using reply_to_message to keep mail headers intact. Without a verified custom domain or operator clearance, dispatching messages to third-party recipients fails immediately with a 403 external_sending_not_enabled error.
What it helps with
- provision dedicated email inboxes for autonomous coding agents
- reply to ongoing email threads while preserving message headers
- hold outgoing messages for account owner review before delivery
- receive inbound message alerts via cryptographically signed webhooks
Example prompts for the agent
- Check for recent unread emails using
list_messages. - Reply to the latest conversation thread using
reply_to_message. - Inspect current sending limits and account identity with
whoami.
How to install e2a — email for AI agents
Platform CLI: remote server
claude mcp add --transport http mcp-server https://api.e2a.dev/mcpPlatform CLI: remote server
codex mcp add mcp --url https://api.e2a.dev/mcpConfig file
{
"mcpServers": {
"mcp": {
"url": "https://api.e2a.dev/mcp"
}
}
}Config file
{
"servers": {
"mcp": {
"type": "http",
"url": "https://api.e2a.dev/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http mcp https://api.e2a.dev/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about e2a — email for AI agents
How to install e2a — email for AI agents in Claude Code?
Run claude mcp add --transport http mcp-server https://api.e2a.dev/mcp in your terminal. Provide your dashboard access token in the authorization header when connecting.
What is the difference between agent and account credential scopes?
Agent credentials only expose 21 operational actions for reading and drafting messages. Account-level keys provide 80 tools that cover domain setup, webhook management, and outbound message approvals.
Why does external email dispatch trigger a 403 status?
The hosted endpoint restricts sending to outside recipients until the account configures a verified custom domain or receives operator approval. Calls violating this rule fail with external_sending_not_enabled.
