# WireCat Mail

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 3 repo stars
- Author: WireCatLabs
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/WireCatLabs/mail-cli
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/wirecat-mail

## What it 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`.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mail-cli -- npx -y @wirecat/mail-cli
```

### Codex

**Platform CLI**
```bash
codex mcp add wirecat-mail -- npx -y @wirecat/mail-cli
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "wirecat-mail": {
            "command": "npx",
            "args": [
                "-y",
                "@wirecat/mail-cli"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "wirecat-mail": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@wirecat/mail-cli"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add wirecat-mail npx -y @wirecat/mail-cli
```

## When to use it
- 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
- 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

## Similar
- [Proton Mail (unofficial)](https://affpapa.org/en/nevibecode/mcp/proton-mail-unofficial.md) — MCP server · ★ 11 repo stars
- [maxxing-mail](https://affpapa.org/en/nevibecode/skills/maxxing-mail.md) — skill · ★ 285 repo stars
- [Agent Mail Gateway](https://affpapa.org/en/nevibecode/mcp/agent-mail-gateway.md) — MCP server · ★ 15 repo stars
- [himalaya](https://affpapa.org/en/nevibecode/skills/community-himalaya.md) — skill · 425 installs
- [Email (IMAP/SMTP)](https://affpapa.org/en/nevibecode/mcp/email-imapsmtp.md) — MCP server · ★ 14 repo stars
- [Proton Bridge MCP](https://affpapa.org/en/nevibecode/mcp/proton-bridge-mcp.md) — MCP server · ★ 2 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
