Skip to content
MCP server

mcp4mail

Connect any IMAP mailbox so Claude, ChatGPT or Grok can search and read your mail

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://mcp4mail.online/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp4mail": {
      "url": "https://mcp4mail.online/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  5. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  6. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media