WireCat Mail — Claude Code MCP server: what it does, how to install
WireCat Mail — an MCP server for Claude Code and Codex syncs mailbox messages into local storage, enabling AI assistants to search, read, organize, draft, and send emails via IMAP and SMTP.
Apache-2.0 ★ 3 updated 2026-11-16
claude mcp add mail-cli -- npx -y @wirecat/mail-cliWhat WireCat Mail does
The server pulls mail via IMAP into a local shared store so the agent can inspect conversations offline using filters for senders, lists, and attachments. It executes mailbox operations on the remote server, including folder management, flagging, and moving items to Trash with undo support. It also handles drafts and sends outbound messages over SMTP.
Execution requires Node.js 22.16+ or 24+ alongside IMAP credentials and an app password. Outbound mail sent by an agent is restricted to the account owner until explicitly widened. Destructive actions such as deleting messages or creating folders fail unless the MCP connection is registered with --allow-writes.
What it helps with
- search stored emails offline with queries for sender or date
- organize mail into folders and move messages to Trash
- compose drafts and send replies over SMTP
- export mail to mbox or Maildir structures
Example prompts for the agent
- Find all invoices received in the last thirty days
- Draft a reply to the latest message from Sarah regarding the project kickoff
- Sync unread messages from the inbox
How to install WireCat Mail
Platform CLI
claude mcp add mail-cli -- npx -y @wirecat/mail-cliPlatform CLI
codex mcp add wirecat-mail -- npx -y @wirecat/mail-cliConfig file
{
"mcpServers": {
"wirecat-mail": {
"command": "npx",
"args": [
"-y",
"@wirecat/mail-cli"
]
}
}
}Config file
{
"servers": {
"wirecat-mail": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@wirecat/mail-cli"
]
}
}
}Platform CLI
gemini mcp add wirecat-mail npx -y @wirecat/mail-cliStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about WireCat Mail
How to install WireCat Mail in Claude Code?
Run claude mcp add wirecat-mail -- npx -y @wirecat/mail-cli.
What does WireCat Mail do?
It caches mailbox messages locally for offline search, manages remote IMAP folders, and drafts or sends emails via SMTP.
What is required to run WireCat Mail?
Node.js 22.16+ or 24+, an IMAP-enabled mailbox, and a generated app password.