# Agenticmail MCP Server (MCP server)

> Agenticmail MCP Server is an MCP server that adds messaging tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Real email and SMS for AI agents — send mail, receive verification codes, drive a real inbox. It has 233 GitHub stars, is released under the MIT license and runs locally with npx -y @agenticmail/mcp.

The MCP (Model Context Protocol) server for AgenticMail — gives any MCP-compatible AI client full email and SMS capabilities.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/agenticmail/agenticmail |
| GitHub stars | 233 |
| License | MIT |
| Language | TypeScript |
| Transport | stdio |
| Packages | npm: @agenticmail/mcp |
| Remote URL | none |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Communication |
| Latest release | agenticmail-cli-v0.9.104 (Jun 5, 2026) |
| Last commit | Sep 13, 2026 |
| MCP registry name | io.github.agenticmail/mcp |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "agenticmail-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@agenticmail/mcp"
      ],
      "env": {
        "AGENTICMAIL_API_KEY": "your-value",
        "AGENTICMAIL_MASTER_KEY": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env AGENTICMAIL_API_KEY=your-value --env AGENTICMAIL_MASTER_KEY=your-value --transport stdio agenticmail-mcp-server -- npx -y @agenticmail/mcp
```

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

```json
{
  "mcpServers": {
    "agenticmail-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@agenticmail/mcp"
      ],
      "env": {
        "AGENTICMAIL_API_KEY": "your-value",
        "AGENTICMAIL_MASTER_KEY": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

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

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "agenticmail_api_key",
      "description": "AGENTICMAIL_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "agenticmail_master_key",
      "description": "AGENTICMAIL_MASTER_KEY",
      "password": true
    }
  ],
  "servers": {
    "agenticmail-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@agenticmail/mcp"
      ],
      "env": {
        "AGENTICMAIL_API_KEY": "${input:agenticmail_api_key}",
        "AGENTICMAIL_MASTER_KEY": "${input:agenticmail_master_key}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `AGENTICMAIL_API_KEY` (secret): Per-agent API key issued when you create the agent. Scopes every tool call to that agent's mailbox and outbound. Either AGENTICMAILAPIKEY or…
- `AGENTICMAIL_MASTER_KEY` (secret): Master key for admin operations (creating agents, listing all accounts, deleting agents). Set this when the MCP client needs admin tools; otherwise prefer the…
- `AGENTICMAIL_API_URL`: Base URL of the AgenticMail HTTP API. Defaults to http://127.0.0.1:3100 (the port the local CLI binds). Override when the API runs on a different host or port.

## Tools

- `send_email`: Send email with to, subject, text/html, attachments, CC
- `list_inbox`: List recent inbox messages (paginated, up to 100)
- `read_email`: Read full email content with security analysis
- `reply_email`: Reply (or reply-all) preserving threading
- `forward_email`: Forward an email with original attachments
- `search_emails`: Search by from, subject, body, date range, relay
- `delete_email`: Delete a specific email by UID
- `move_email`: Move email to a folder
- `mark_read`: Mark email as read
- `mark_unread`: Mark email as unread
- `inbox_digest`: Get inbox summary with body previews
- `wait_for_email`: Wait for new email in real time (up to 5 minutes)
- `import_relay_email`: Import email from connected Gmail/Outlook
- `batch_delete`: Delete multiple emails by UID list
- `batch_mark_read`: Mark multiple emails as read
- `batch_mark_unread`: Mark multiple emails as unread
- `batch_move`: Move multiple emails to a folder
- `batch_read`: Read multiple full emails at once
- `manage_contacts`: Add, remove, and list contacts in address book
- `manage_drafts`: Create, list, edit, delete, and send drafts
- `manage_tags`: Create tags, assign to messages, remove, list
- `manage_rules`: Create email filtering rules (auto-move, auto-delete, mark read)
- `manage_signatures`: Create, list, and delete email signatures
- `manage_templates`: Create, list, and delete email templates
- `manage_scheduled`: Schedule emails for future delivery, list, cancel
- `manage_spam`: List spam folder, report spam, mark as not-spam, get spam score
- `manage_pending_emails`: View blocked outbound emails awaiting approval
- `template_send`: Send email using a saved template with variable substitution
- `create_folder`: Create a new IMAP folder
- `list_folder`: List messages in a specific folder
- `list_folders`: List all available folders
- `check_health`: Check AgenticMail server and Stalwart health
- `list_agents`: List all agents with name, email, role
- `message_agent`: Send email to another agent (with priority levels)
- `check_messages`: Check for new messages from agents and externals
- `call_agent`: Call another agent with a task (sync or async)
- `claim_task`: Claim a pending task assigned to you
- `submit_result`: Submit result for a claimed task
- `check_tasks`: Check incoming or outgoing tasks
- `create_account`: Create a new agent with name and role

## Similar MCP servers

- [Strata](https://appsgit.com/mcp-servers/strata): MCP server for progressive tool usage at any scale (see https://klavis.ai). (5,807 stars, Apache-2.0, official)
- [Vexa](https://appsgit.com/mcp-servers/vexa): Meeting bot and transcripts for Google Meet, Teams and Zoom. (2,856 stars, Apache-2.0, official, needs API key)
- [MCP Server for WinDbg Crash Analysis](https://appsgit.com/mcp-servers/mcp-server-for-windbg-crash-analysis): A Model Context Protocol server for Windows crash dump analysis using WinDbg/CDB. (1,607 stars, MIT)
- [Rocketmq Rust](https://appsgit.com/mcp-servers/rocketmq-rust): 🚀 Apache RocketMQ built in Rust 🦀 — faster, safer, and more memory-efficient. (1,524 stars, Apache-2.0)
- [Wassette](https://appsgit.com/mcp-servers/wassette): Wassette: A security-oriented runtime that runs WebAssembly Components via MCP. (957 stars, MIT, official)
- [Line Bot MCP Server](https://appsgit.com/mcp-servers/line-bot-mcp-server): MCP server that integrates the LINE Messaging API to connect an AI Agent to the LINE Official Account. (783 stars, Apache-2.0, official, needs API key)

---

Canonical page: https://appsgit.com/mcp-servers/agenticmail-mcp-server
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.