WireCat Mail
CLI and MCP server that syncs an IMAP mailbox locally so agents can search and draft mail
- 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-cliAdd to claude_desktop_config.json
{
"mcpServers": {
"mail-cli": {
"command": "npx",
"args": [
"-y",
"@wirecat/mail-cli"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mail-cli": {
"command": "npx",
"args": [
"-y",
"@wirecat/mail-cli"
]
}
}
}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.

