Mail MCP Server

Filtered, read-only IMAP and Gmail archived to disk as .eml + markdown, served over MCP.

Remote serverstreamable-httpGo

What is the Mail MCP Server?

Filtered, read-only IMAP and Gmail archived to disk as .eml + markdown, served over MCP.

What the server does

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
nameagent-inbox
list_rulesWhat am I collecting, and which senders am I subscribed to *right now*? Each from_domains_file is re-read on every call.
list_messagesWhat has arrived? Filter by rule, account, thread or date; optionally grouped into conversations.
search_messagesWhere is the message that mentions X? Substring search over subject, sender, recipients, labels, attachment names and body.
read_messageOne message in full — metadata, body, attachment names and sizes — and optionally its whole thread in order.
syncFetch new mail once, returning the same manifest run --json writes.
gmail-archiveIt was almost exactly this — Gmail query to Maildir, incremental — and would be the obvious answer if it were still maintained. It has not been since 2018.
gmail-exporterYou want a one-off, label-based, spreadsheet-shaped export rather than incremental sync.

How to install the Mail MCP Server

{
  "mcpServers": {
    "mail-muncher": {
      "command": "/usr/local/bin/mail-muncher",
      "args": [
        "mcp",
        "--config",
        "/Users/you/.config/mail-muncher/config.yml"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Example prompts to try

  • “Use Mail to Gmail.”
  • “Use Mail to IMAP.”
  • “Use Mail to name.”

Frequently asked questions

Filtered, read-only IMAP and Gmail archived to disk as .eml + markdown, served over MCP. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.