Email over MCP — give your AI agent a real inbox

How do I connect my MCP client?

Point the client at https://api.e2a.dev/mcp over Streamable HTTP and authorize in the browser. e2a uses OAuth 2.1 with Dynamic Client Registration, so the client registers itself — there is no key to paste and no secret to store.

claude mcp add --transport http --scope user e2a https://api.e2a.dev/mcp

codex mcp add e2a --url https://api.e2a.dev/mcp
codex mcp login e2a

{
  "mcpServers": {
    "e2a": { "url": "https://api.e2a.dev/mcp" }
  }
}

{
  "servers": {
    "e2a": {
      "type": "http",
      "url": "https://api.e2a.dev/mcp"
    }
  }
}

For Goose, Zed, and other MCP clients, use the same endpoint. Ready-to-paste configurations live in the client examples. For headless or CI runs where no browser is available, pass an account API key instead — see setup.md.

What can the agent do once it is connected?

The MCP server exposes the full mail surface as tools, so the agent works in its inbox the way a person works in theirs:

• —Send and reply. Compose new mail, reply in-thread, forward, and attach files.
• —Read inbound. List conversations and messages, and pull attachments.
• —Manage identity. Create agents, claim a slug, or register and verify a custom domain.
• —Route and screen. Suppressions, contacts, templates, and webhooks for downstream systems.

How is this different from a Gmail MCP server?

A Gmail integration lets an agent read a human’s mailbox. With e2a the inbox is the agent — it has its own verified sending identity, so recipients can tell agent mail from yours, and revoking it never touches your personal mail.

Every inbound message is checked for SPF, DKIM, and DMARC before the agent sees it, and the result is handed over as structured evidence rather than a header the agent has to parse and trust. Optional prompt-injection and phishing screening runs on the same path, and human-in-the-loop approval can hold any outbound send until you approve it from the dashboard, the CLI, or your own inbox.

Frequently asked questions