BACK TO MCP SERVERS
commsany

Atomic Mail

Programmable email inbox for AI agents, JMAP, PoW auth, stdio MCP server.

At a glance

Not tested yet
GitHub stars
256
Weekly downloads
578
Last commit
2026-11-20
Licence
MIT
Transport
stdio
Auth
api-key
Install
npx -y @atomicmail/mcp-modelcontextprotocol
Stats checked 2026-11-21

What it does

Atomic Mail is an email provider for autonomous AI agents. Agents register their own @atomicmail.ai inbox and manage it end to end, with no human setup, verification, or ongoing intervention. It is built on JMAP, a standard mailbox API, so agents can read and send mail, create drafts, manage threads, and search. It is for people who want an agent to run a dedicated inbox without touching their personal mailbox.

Atomic Mail Agentic Logo
Image: atomic-mail/atomic-mail-agentic (MIT)

Tools it gives your agent

  • register: registers an inbox, or connects to a custom-domain inbox with an API key.
  • jmap_request: runs JMAP operations, including bundled presets such as search, mark_read, get_thread, forward, create_draft, move, label, delete, and download_attachment.
  • help: returns embedded docs, presets, cron notes, troubleshooting, cheatsheets, and worked examples.
  • read_inbox: reads the inbox.
  • read_message: reads a single message.
  • search_messages: searches messages.
  • send_email: sends mail with plain text and/or HTML, From name, Reply-To, and attachments.
  • reply_to_message: replies to a message.
  • list_agents: lists agents.

Quick start

Ask your agent to create an inbox, then restart the host.

npx --package=@atomicmail/agent-skill-github atomicmail register --username "myagent" --watch scheduled
npx --package=@atomicmail/agent-skill-github atomicmail jmap_request --ops-file list_inbox.json
npx --package=@atomicmail/agent-skill-github atomicmail help

Add this to .mcp.json in your project root (Claude Code) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "atomic-mail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@atomicmail/mcp-modelcontextprotocol"
      ],
      "env": {
        "ATOMIC_MAIL_CREDENTIALS_DIR": "YOUR_ATOMIC_MAIL_CREDENTIALS_DIR",
        "ATOMIC_MAIL_API_KEY": "YOUR_ATOMIC_MAIL_API_KEY",
        "ATOMIC_MAIL_AUTH_URL": "YOUR_ATOMIC_MAIL_AUTH_URL",
        "ATOMIC_MAIL_API_URL": "YOUR_ATOMIC_MAIL_API_URL",
        "ATOMIC_MAIL_INBOX_DOMAIN": "YOUR_ATOMIC_MAIL_INBOX_DOMAIN"
      }
    }
  }
}

Replace each YOUR_ value with your own, and delete the variables you do not use.

Environment variables

  • ATOMIC_MAIL_CREDENTIALS_DIR: the sources mention separate credential dirs per inbox when you run many agents.
  • ATOMIC_MAIL_API_KEY: declared by the server. The README does not explain it.
  • ATOMIC_MAIL_AUTH_URL: declared by the server. The README does not explain it.
  • ATOMIC_MAIL_API_URL: declared by the server. The README does not explain it.
  • ATOMIC_MAIL_INBOX_DOMAIN: declared by the server. The README does not explain it.

Example prompts

  • Create an inbox at Atomic Mail. Ask me for my preferred username first.
  • Subscribe this inbox to these newsletters, read everything, and email me a daily digest.
  • Monitor the support inbox and reply to tickets from our docs. Escalate to me only when you cannot answer.
  • Run an email survey: send these questions, follow up based on replies, and summarize the findings.

What to watch out for

  • Accounts are free with a 100 MB storage quota.
  • Signup uses a proof-of-work protocol, and the connectors exist mainly to abstract away its complexity.
  • Custom domains need DNS changes on a domain you own, done once in the dashboard.
  • The REST API is for custom connectors and advanced logic only.

Not tested by tools4agents yet. Read the source repository before you install it.

GitHub SourceGitHub Stars
Last verified 2026-11-21

Similar tools