Atomic Mail MCP Server

by atomic-mailio.github.Atomic-Mail/mcpv0.3.27

Email for AI agents: autonomous inbox registration via proof-of-work, custom domains, and sending and receiving over the open JMAP standard.

266Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active12d ago

Install Atomic Mail MCP server

claude mcp add modelcontextprotocol -e ATOMIC_MAIL_API_KEY='<atomic-mail-api-key>' -- npx -y @atomicmail/mcp-modelcontextprotocol

{
  "mcpServers": {
    "modelcontextprotocol": {
      "command": "npx",
      "args": [
        "-y",
        "@atomicmail/mcp-modelcontextprotocol"
      ],
      "env": {
        "ATOMIC_MAIL_API_KEY": "<atomic-mail-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "modelcontextprotocol": {
      "command": "npx",
      "args": [
        "-y",
        "@atomicmail/mcp-modelcontextprotocol"
      ],
      "env": {
        "ATOMIC_MAIL_API_KEY": "<atomic-mail-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "modelcontextprotocol": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@atomicmail/mcp-modelcontextprotocol"
      ],
      "env": {
        "ATOMIC_MAIL_API_KEY": "<atomic-mail-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "modelcontextprotocol": {
      "command": "npx",
      "args": [
        "-y",
        "@atomicmail/mcp-modelcontextprotocol"
      ],
      "env": {
        "ATOMIC_MAIL_API_KEY": "<atomic-mail-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
ATOMIC_MAIL_CREDENTIALS_DIR	—	—	Override default credential directory (~/.atomicmail/)
ATOMIC_MAIL_API_KEY	—	yes	Existing API key — skips PoW registration
ATOMIC_MAIL_AUTH_URL	—	—	Override auth service base URL
ATOMIC_MAIL_API_URL	—	—	Override JMAP API base URL
ATOMIC_MAIL_INBOX_DOMAIN	—	—	Default inbox domain when inboxId has no @ (default: atomicmail.ai)

Remote endpoints

streamable-httphttps://mcp.atomicmail.ai/mcp

Freshness

Active — last maintenance signal 12d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-27 · 12d ago · GitHub
Latest release
2026-09-27 · 12d ago · GitHub · v0.3.31
Package published
no data · npm/PyPI
Registry entry updated
2026-09-18 · 21d ago · official registry · v0.3.27

FAQ

›How do I install the Atomic Mail MCP server in Claude Code?

Run: claude mcp add modelcontextprotocol -e ATOMIC_MAIL_API_KEY='<atomic-mail-api-key>' -- npx -y @atomicmail/mcp-modelcontextprotocol. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Atomic Mail require an API key?

Yes. It expects ATOMIC_MAIL_API_KEY, of which 1 is a secret.

›Can I use Atomic Mail as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Atomic Mail in the official MCP registry?

Yes, as io.github.Atomic-Mail/mcp.