# Atomic Mail

Atomic Mail connects an AI agent to an inbox for reading, sending, searching, and drafting email. Use it to handle mailbox tasks from Claude Code.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 264
- Author: Atomic-Mail
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Atomic-Mail/atomic-mail-agentic
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/atomic-mail

## What it does

Atomic Mail gives an agent an inbox and access to email operations through JMAP, including reading and sending messages, managing drafts and threads, and searching. Its MCP integration exposes `register`, `jmap_request`, and `help`; connect it over HTTP or run it with stdio.

Inbox signup uses proof of work and does not require CAPTCHA or manual approval. In Claude Code, add the HTTP server with the command below and restart the host. The stdio option needs values for `ATOMIC_MAIL_CREDENTIALS_DIR`, `ATOMIC_MAIL_API_KEY`, `ATOMIC_MAIL_AUTH_URL`, `ATOMIC_MAIL_API_URL`, and `ATOMIC_MAIL_INBOX_DOMAIN`, so you’ll need those before configuring that route.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.atomicmail.ai/mcp`
- Environment variables: `ATOMIC_MAIL_CREDENTIALS_DIR`, `ATOMIC_MAIL_API_KEY`, `ATOMIC_MAIL_AUTH_URL`, `ATOMIC_MAIL_API_URL`, `ATOMIC_MAIL_INBOX_DOMAIN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.atomicmail.ai/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env ATOMIC_MAIL_CREDENTIALS_DIR=<ATOMIC_MAIL_CREDENTIALS_DIR> --env ATOMIC_MAIL_API_KEY=<ATOMIC_MAIL_API_KEY> --env ATOMIC_MAIL_AUTH_URL=<ATOMIC_MAIL_AUTH_URL> --env ATOMIC_MAIL_API_URL=<ATOMIC_MAIL_API_URL> --env ATOMIC_MAIL_INBOX_DOMAIN=<ATOMIC_MAIL_INBOX_DOMAIN> --transport stdio atomic-mail -- npx -y @atomicmail/mcp-modelcontextprotocol
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add atomic-mail --url https://mcp.atomicmail.ai/mcp
```

2. **Platform CLI**
```bash
codex mcp add atomic-mail --env ATOMIC_MAIL_CREDENTIALS_DIR=<ATOMIC_MAIL_CREDENTIALS_DIR> --env ATOMIC_MAIL_API_KEY=<ATOMIC_MAIL_API_KEY> --env ATOMIC_MAIL_AUTH_URL=<ATOMIC_MAIL_AUTH_URL> --env ATOMIC_MAIL_API_URL=<ATOMIC_MAIL_API_URL> --env ATOMIC_MAIL_INBOX_DOMAIN=<ATOMIC_MAIL_INBOX_DOMAIN> -- npx -y @atomicmail/mcp-modelcontextprotocol
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "atomic-mail": {
            "url": "https://mcp.atomicmail.ai/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "atomic-mail": {
            "command": "npx",
            "args": [
                "-y",
                "@atomicmail/mcp-modelcontextprotocol"
            ],
            "env": {
                "ATOMIC_MAIL_CREDENTIALS_DIR": "<ATOMIC_MAIL_CREDENTIALS_DIR>",
                "ATOMIC_MAIL_API_KEY": "<ATOMIC_MAIL_API_KEY>",
                "ATOMIC_MAIL_AUTH_URL": "<ATOMIC_MAIL_AUTH_URL>",
                "ATOMIC_MAIL_API_URL": "<ATOMIC_MAIL_API_URL>",
                "ATOMIC_MAIL_INBOX_DOMAIN": "<ATOMIC_MAIL_INBOX_DOMAIN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "atomic-mail": {
            "type": "http",
            "url": "https://mcp.atomicmail.ai/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "atomic-mail": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@atomicmail/mcp-modelcontextprotocol"
            ],
            "env": {
                "ATOMIC_MAIL_CREDENTIALS_DIR": "<ATOMIC_MAIL_CREDENTIALS_DIR>",
                "ATOMIC_MAIL_API_KEY": "<ATOMIC_MAIL_API_KEY>",
                "ATOMIC_MAIL_AUTH_URL": "<ATOMIC_MAIL_AUTH_URL>",
                "ATOMIC_MAIL_API_URL": "<ATOMIC_MAIL_API_URL>",
                "ATOMIC_MAIL_INBOX_DOMAIN": "<ATOMIC_MAIL_INBOX_DOMAIN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http atomic-mail https://mcp.atomicmail.ai/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e ATOMIC_MAIL_CREDENTIALS_DIR=<ATOMIC_MAIL_CREDENTIALS_DIR> -e ATOMIC_MAIL_API_KEY=<ATOMIC_MAIL_API_KEY> -e ATOMIC_MAIL_AUTH_URL=<ATOMIC_MAIL_AUTH_URL> -e ATOMIC_MAIL_API_URL=<ATOMIC_MAIL_API_URL> -e ATOMIC_MAIL_INBOX_DOMAIN=<ATOMIC_MAIL_INBOX_DOMAIN> atomic-mail npx -y @atomicmail/mcp-modelcontextprotocol
```
Replace <…> with your own values

## When to use it
- create an inbox for an AI agent
- read email through JMAP
- search a mailbox for a specific thread
- prepare an email draft
- send a message from an agent

## Example prompts
- Create an Atomic Mail inbox for me.
- Find the email thread about the approval and summarize it.
- Draft a reply to the latest message from the client.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md