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
npx -y @atomicmail/mcp-modelcontextprotocol
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.

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 assearch,mark_read,get_thread,forward,create_draft,move,label,delete, anddownload_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.
Similar tools
Smitline: AI Phone Calls & Meetings
Let AI agents make phone calls and join Zoom, Teams and Google Meet meetings. Hosted or self-hosted.
Slack
Read channels, search message history, and post updates, so an agent can pull context from where decisions actually happened.
OpenDocKit
Read local PDF, Office, HWP, OpenDocument, RTF, EPUB, HTML and email files as Markdown. Offline.
IMAP/SMTP email for AI agents, read, send, organize, and manage attachments across accounts.