# mcp

The AgenticMail MCP server gives an AI agent a real inbox: send mail and texts, read replies, grab verification codes, manage contacts and hand tasks to other agents.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 240
- Author: agenticmail
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/agenticmail/agenticmail/tree/HEAD/packages/mcp
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/agenticmail-mcp

## What it does

It runs as a subprocess the client talks to over standard input and output, so no network ports are opened. Each tool call becomes a request to the AgenticMail API, and the answer comes back as text the model can read. The package advertises 100 tools covering email, SMS and agent management: send, reply, forward, templates, drafts, contacts, scheduled sends.

Multi-agent work has its own tier. `call_agent` takes an `outputSchema` and validates `submit_result` against it, so a worker retries with the right shape instead of returning prose. `check_activity` shows which agents the dispatcher woke, what they are running and how long, with a `stale` flag from heartbeat age. `tail_worker` returns the last lines of a worker log. The `wake` parameter on send tools decides who gets a turn, and `[FINAL]`, `[DONE]`, `[CLOSED]` or `[WRAP]` in a subject seals the thread.

You need Node.js 22+ and a running AgenticMail API server, plus `AGENTICMAIL_API_KEY` and `AGENTICMAIL_MASTER_KEY`. In `--http` mode the server binds to `127.0.0.1` and requires `Authorization: Bearer <token>` on every `/mcp` request; the token is minted on first start into `~/.agenticmail/mcp-http-token`. Without an API key nothing starts.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `AGENTICMAIL_API_KEY`, `AGENTICMAIL_MASTER_KEY`, `AGENTICMAIL_API_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env AGENTICMAIL_API_KEY=<AGENTICMAIL_API_KEY> --env AGENTICMAIL_MASTER_KEY=<AGENTICMAIL_MASTER_KEY> --env AGENTICMAIL_API_URL=<AGENTICMAIL_API_URL> --transport stdio mcp -- npx -y @agenticmail/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mcp --env AGENTICMAIL_API_KEY=<AGENTICMAIL_API_KEY> --env AGENTICMAIL_MASTER_KEY=<AGENTICMAIL_MASTER_KEY> --env AGENTICMAIL_API_URL=<AGENTICMAIL_API_URL> -- npx -y @agenticmail/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@agenticmail/mcp"
            ],
            "env": {
                "AGENTICMAIL_API_KEY": "<AGENTICMAIL_API_KEY>",
                "AGENTICMAIL_MASTER_KEY": "<AGENTICMAIL_MASTER_KEY>",
                "AGENTICMAIL_API_URL": "<AGENTICMAIL_API_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@agenticmail/mcp"
            ],
            "env": {
                "AGENTICMAIL_API_KEY": "<AGENTICMAIL_API_KEY>",
                "AGENTICMAIL_MASTER_KEY": "<AGENTICMAIL_MASTER_KEY>",
                "AGENTICMAIL_API_URL": "<AGENTICMAIL_API_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e AGENTICMAIL_API_KEY=<AGENTICMAIL_API_KEY> -e AGENTICMAIL_MASTER_KEY=<AGENTICMAIL_MASTER_KEY> -e AGENTICMAIL_API_URL=<AGENTICMAIL_API_URL> mcp npx -y @agenticmail/mcp
```
Replace <…> with your own values

## When to use it
- send an email or text from inside an agent
- pull a verification code out of an incoming message
- reply in the right thread
- wake only the agents that need to act
- check whether the agent you emailed actually started

## Example prompts
- Send an email to `team@example.com` with the subject "Weekly report"
- Check the inbox and show me what arrived in the last hour
- Reply to the latest message and add `[DONE]` to the subject

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

## Other versions with the same name
- [mcp · kubeshark](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — ★ 12109
- [mcp · butterbase-ai](https://affpapa.org/en/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3031
- [mcp · medplum](https://affpapa.org/en/nevibecode/mcp/mcp.md) — ★ 2760
- [mcp · sceneview](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — ★ 1348
- [mcp · buoy-gg](https://affpapa.org/en/nevibecode/mcp/buoy-gg-mcp.md) — ★ 691

From the same set: [agenticmail/agenticmail](https://affpapa.org/en/nevibecode/by/agenticmail/agenticmail.md) — 2 cards

---
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