What it does
mcp-mail is a self-hosted MCP server that connects any IMAP/SMTP mailbox to MCP clients such as Claude Desktop, Claude Code, Cursor, VS Code and ChatGPT. Clients can list folders, search and read messages and threads, download attachments, save drafts, send mail with attachments and signatures, mark, flag and move messages, and delete them to Trash. Calendar tools for CalDAV servers are optional and cover reading events, finding free time and creating events. Access is controlled per client through presets, tool allow and deny lists, mailbox scope, a recipient allowlist and a send rate limit. An audit log in JSONL format records activity without message content.
It suits cases where an AI client needs to work with existing email, such as drafting replies or summarising a thread, while the mailbox owner limits what that client can do. A read-only preset lets ChatGPT see only the read tools, and omitting the send tool from an agent's preset removes it from that agent's list. Individual clients can be revoked without affecting the others. The project describes itself as a maintained continuation of claude-mail-mcp, and existing claude-mail-mcp v0.2 installations can switch without configuration changes. Other IMAP-based MCP servers exist, and the publisher lists several in its documentation.
Local clients can run the server directly over stdio through npx. Remote clients use Streamable HTTP, which supports built-in OAuth 2.1 and per-client tokens. Mailbox credentials are kept in accounts.json on the server, optionally encrypted at rest. For Gmail, iCloud, Yahoo and Fastmail, an app password is used in place of the normal password.
Limitations and requirements
Requires a self-hosted server and access to an IMAP/SMTP mailbox. Gmail, iCloud, Yahoo and Fastmail need an app password created in the provider's security settings. ChatGPT access requires OAUTH=true and ChatGPT's developer mode. Calendar features require a CalDAV server and are optional. Credentials are stored in accounts.json on the server unless encryption is enabled. Publisher advice: keep sending switched off for agents that do not need it.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
mcp-mail
Self-hosted IMAP/SMTP email for any MCP client, with per-client permissions and audit log.
v1.2.1As shown on registry.modelcontextprotocol.io when we last read it