# Command Mail MCP server

> Allows an AI agent to read, search, sort, draft, and send emails across multiple addresses through a unified inbox.

- Repository: https://github.com/FYN-Labs/commandmail-plugin
- Page: https://hostedmcp.org/servers/fyn-labs/commandmail-plugin
- Transport: remote
- Stars: 0
- License: MIT
- Latest version: 0.2.0

## Install

### Claude Code

```sh
claude mcp add --transport http commandmail-plugin https://commandmail.app/mcp
```

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

```json
{
  "mcpServers": {
    "commandmail-plugin": {
      "url": "https://commandmail.app/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "commandmail-plugin": {
      "type": "http",
      "url": "https://commandmail.app/mcp"
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"commandmail-plugin","type":"http","url":"https://commandmail.app/mcp"}'
```

### Codex

```sh
codex mcp add commandmail-plugin --url https://commandmail.app/mcp
```

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

```toml
[mcp_servers.commandmail-plugin]
url = "https://commandmail.app/mcp"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http commandmail-plugin https://commandmail.app/mcp
```

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

```json
{
  "mcpServers": {
    "commandmail-plugin": {
      "url": "https://commandmail.app/mcp",
      "type": "http"
    }
  }
}
```

## FAQ

### What is the difference between the Free and Pro plans?

The Free plan includes one mailbox with 90 days of history and allows reading, searching, and drafting, but prevents the agent from sending mail. The Pro plan adds sending capabilities, up to ten mailboxes, and full mail history.

### How do I sign in and secure my account?

You sign in via your browser using OAuth 2.1 with PKCE, meaning you never have to provide your password or an API key to the agent.

### Can the agent send emails without my permission?

By default, sending is switched off; you can grant specific permissions for the agent to send approved drafts or send without approval within certain limits.
