mcp4mail
Connect any IMAP mailbox so Claude, ChatGPT or Grok can search and read your mail
- Pricing
- Open source
- Platforms
- Web, self-hosted, API
- Runs
- Remotely
- Version
- 1.0.0
- Listing updated
- 1 day ago
About mcp4mail
mcp4mail is an open-source MCP server for communication. It runs as a hosted remote server, so there is nothing to install locally.
mcp4mail is built around a cautious default: every connected mailbox is read-only, so an assistant can list, search and read but cannot send, move, delete or even mark a message as read. The owner can switch on changes per mailbox and then tick which actions are allowed, such as flagging, moving, drafting, sending or trashing. Anything the assistant wants to send waits until a human presses Send in an email the service sends back.
You add a mailbox with an app password rather than your main password, and the AI client authorises through OAuth 2.1, never seeing that password. It works with Gmail, iCloud, Outlook, Seznam, Fastmail, Zoho and other IMAP providers, and one connector can hold several mailboxes and open attachments. The hosted service stores the password encrypted, while the open-source project can be self-hosted with docker compose so credentials stay on your own machine.
The README offers an unusual note on provenance: the project is primarily developed by AI agents orchestrated through a task tool, with humans writing briefs and reviewing pull requests.
Install
Run in a terminal
claude mcp add --transport http mcp4mail https://mcp4mail.online/mcpAdd to Settings → Connectors → Add custom connector
https://mcp4mail.online/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp4mail": {
"url": "https://mcp4mail.online/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp4mail": {
"type": "http",
"url": "https://mcp4mail.online/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp4mail": {
"serverUrl": "https://mcp4mail.online/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp4mail": {
"type": "http",
"url": "https://mcp4mail.online/mcp"
}
}
}Tools this server provides (8)
Taken from the project documentation; the running server may differ.
- list_mail_accounts
- List connected mail accounts
- get_mail_account
- Show one account's connection details (never its password)
- list_folders
- List an account's folders
- search_messages
- Search by subject, sender, recipients, attachment names and date
- get_message
- Read one message
- get_attachment
- Download an attachment
- search_contacts
- Find addresses you have corresponded with
- get_outgoing_status
- Check status of outgoing messages
What it does
- Read-only by default
- Assistants can list, search and read until you allow changes.
- Per-action permissions
- Tick flagging, moving, drafting, sending or deleting.
- Send approval
- Outgoing mail waits for a human to press Send.
- Attachment access
- Download attachments via short-lived links or inline up to 5 MB.
- Multiple mailboxes
- Several accounts in one connector.
- Self-hostable
- Run it yourself with docker compose.
- Audit log
- Records each call by client and tool.
Good for
- Asking which emails still need a reply
- Finding an order confirmation and delivery date
- Summarising a long thread across folders
- Looking up contacts you have corresponded with
Pricing
Open source
Free and open source; hosted at mcp4mail.online or self-hosted
Prices change. Check mcp4mail.online before you buy.
mcp4mail FAQ
Is it free?
The site calls it free and open source.
Does the AI see my password?
No. You enter an app password and the client connects through OAuth 2.1.
Can the assistant send mail on its own?
No. send_message prepares an email that goes out only after a human presses Send.
Which providers work?
Gmail, iCloud, Outlook, Fastmail, Zoho, Seznam and any IMAP mailbox.
Is mcp4mail free?
Yes. mcp4mail is open source, so you can use and self-host it for free.
How do I add mcp4mail to Claude Code?
Run this command in your terminal: claude mcp add --transport http mcp4mail https://mcp4mail.online/mcp
What are the best alternatives to mcp4mail?
The closest alternatives to mcp4mail are Ha MCP, Concord MCP, note1, BoardAgent and Callout.
Alternatives to mcp4mail

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media