Skip to content
MCP server

WireCat Mail

CLI and MCP server that syncs an IMAP mailbox locally so agents can search and draft mail

Runs locally
Install
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.34.0
Listing updated
5 days ago

Similar MCP servers

About WireCat Mail

WireCat Mail is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.

WireCat Mail copies a mailbox into a local store on your computer, so people and agents can search it offline without any WireCat server seeing the mail. It works with IMAP and app passwords across common providers, and a Gmail Takeout mbox file can be imported. Searching uses a query language such as from:, has:attachment and date>30d, and mail can be exported to mbox or Maildir.

It can also organise the live mailbox, with flags, folders and moves, and deletion goes to Trash. Every change run is recorded so messages restore can undo it. Drafts go to the Drafts folder, and sending, replying and forwarding use the provider's SMTP. Over MCP an agent finds commands through a search tool and runs them through read and write tools, with the profile's permissions deciding what runs. An agent mails only you until you allow more, and deletions of many messages return a preview first.

The README warns that everything inside a message is written by someone else and an agent must treat it as data, not instructions. It needs Node.js 22.16 or later, and the MCP setup refuses to proceed without --allow-writes. For ChatGPT or Claude in the browser, mcp serve --http runs behind your own tunnel.

Install

Run in a terminal

claude mcp add mail-cli -- npx -y @wirecat/mail-cli

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mail-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@wirecat/mail-cli"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mail-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@wirecat/mail-cli"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mail-cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@wirecat/mail-cli"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mail-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@wirecat/mail-cli"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mail-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@wirecat/mail-cli"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

read
Runs read-only commands, such as sync into the store and search
write
Runs commands that change the mailbox and local settings

What it does

Local mailbox store
Syncs recent mail into a store on your computer for offline search.
Undoable changes
Deletion goes to Trash and each change run can be restored.
Draft and send
Keeps drafts and sends, replies and forwards over SMTP.
Export
Writes mbox or Maildir++ for tools like mu and notmuch.
Permission-limited MCP
Read and write tools obey profile permissions and a mail-only-me default.
Mailbox triage
Groups mail by sender and list with a spam score before syncing.

Good for

  • Search years of email for an invoice offline
  • Have an agent draft a reply for you to send
  • Back up a mailbox to Maildir
  • Clean up newsletters with previewed deletions
  • Import a Google Takeout archive

Pricing

Open source

WireCat Mail FAQ

Does my mail leave my computer?

The README says the store is a local file and no WireCat server sees your mail.

Can an agent delete my mail?

Deletions move mail to Trash, large changes show a preview and can be undone, and permissions limit what runs.

What do I need to set up?

Turn on IMAP, create an app password, and install with npm on Node.js 22.16 or later.

Why does MCP setup need --allow-writes?

The write tool can run commands that change the mailbox and local settings.

Is WireCat Mail free?

Yes. WireCat Mail is open source, so you can use and self-host it for free.

How do I add WireCat Mail to Claude Code?

Run this command in your terminal: claude mcp add mail-cli -- npx -y @wirecat/mail-cli

What are the best alternatives to WireCat Mail?

The closest alternatives to WireCat Mail are TrendRadar, Ha MCP, Concord MCP, Getmitra and note1.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers