# WireCat Mail MCP server

> Lets AI agents search, organize, draft, and send emails by syncing mailboxes into a local shared store.

- Repository: https://github.com/WireCatLabs/mail-cli
- Page: https://hostedmcp.org/servers/wirecatlabs/mail-cli
- Transport: stdio
- Stars: 3
- License: Apache-2.0
- Latest version: 0.33.0

## Install

### Claude Code

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

### Cursor (`~/.cursor/mcp.json`)

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

### VS Code (`.vscode/mcp.json`)

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

### VS Code CLI

```sh
code --add-mcp '{"name":"mail-cli","type":"stdio","command":"npx","args":["-y","@wirecat/mail-cli"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

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

### Codex

```sh
codex mcp add mail-cli -- npx -y @wirecat/mail-cli
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mail-cli]
command = "npx"
args = ["-y", "@wirecat/mail-cli"]
```

### Gemini CLI

```sh
gemini mcp add -s user mail-cli npx -- -y @wirecat/mail-cli
```

### Gemini settings.json (`~/.gemini/settings.json`)

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

## FAQ

### How can an AI agent use this server?

Agents can use the MCP server to search, read, and write to your mailbox. You can install instructions specifically for Claude Code, Codex, Gemini CLI, and OpenClaw.

### Is my email data sent to WireCat servers?

No, your mail stays on your computer in a local file store, and no WireCat server sees your mail.

### What authentication methods are supported?

The server supports app passwords via IMAP and OAuth for services like Outlook.com and Microsoft 365.
