Assistant Mail MCP

assistantmail-mcp

MCP server for AssistantMail — give AI agents a managed mailbox to send and receive email.

Built for personal and small-team OpenClaw / Hermes operators who want agent email with allowlist, consent, retention, and spend caps you control. Listed on ClawHub for easy install — not an official OpenClaw endorsement.

Get Free · Docs · Website · Privacy · Terms · Contributing

OpenClaw / ClawHub

openclaw skills install @assistantmail/assistant-mail

Then configure your MCP client to run this server and set ASSISTANT_MAIL_API_KEY (Claude Desktop and Cursor examples below). Skill: assistant-mail on ClawHub. Same MCP works with Hermes.

Installation

npx -y @assistantmail/assistantmail-mcp

Node 24+.

Claude Desktop

{

"mcpServers": { "assistantmail": { "command": "npx", "args": ["-y", "@assistantmail/assistantmail-mcp"], "env": { "ASSISTANT_MAIL_API_KEY": "amk_..." } } } }

Cursor / VS Code (.cursor/mcp.json or .vscode/mcp.json)

{

"servers": { "assistantmail": { "command": "npx", "args": ["-y", "@assistantmail/assistantmail-mcp"], "env": { "ASSISTANT_MAIL_API_KEY": "amk_..." } } } }

Prerequisites

1. Create a free account via the Get Free link above (1 agent, 25/day; current limits: Docs).
2. Go to API Keys and create a key (amk_...). Copy it immediately — it is only shown once.
3. Set ASSISTANT_MAIL_API_KEY; call assistantmail_list_mailboxes to get your mailboxId UUID. Mail API routes use that UUID, not an email address.

Paid plans: upgrade in-app only (not Payment Links). Use Upgrade in the AssistantMail app — checkout is not sold via Stripe Payment Links. Docs: assistant-mail.ai/docs

Official MCP Registry

The listing is live as io.github.AssistantMail/assistantmail-mcp on the Official MCP Registry. Product docs: assistant-mail.ai/docs.

Packaging lives in server.json. After a version bump, republish with mcp-publisher — see docs/MCP_REGISTRY.md.

Environment variables

Tools

Diagnostics

Account

Mailboxes

Messages

Recipients

Reference tools

These return raw REST endpoint details rather than calling the API. Use them when you need to construct a request manually or inspect the exact URL and response schema.

Quick start

API_KEY="amk_..."

BASE="https://api.assistant-mail.ai"

1) Discover your mailboxId

curl "$BASE/v1/mailboxes" -H "x-api-key: $API_KEY"

2) Send an email

curl -X POST "$BASE/v1/mailboxes/ /messages" \ -H "x-api-key: $API_KEY" \ -H "Content-Type: application/json" \ -d '{"to":"recipient@example.com","subject":"Hello","text":"Hi there"}'

3) Read inbox

curl "$BASE/v1/mailboxes/ /messages" -H "x-api-key: $API_KEY"

Tool call examples

{ "tool": "assistantmail_list_mailboxes", "input": { "apiKey": "amk_..." } }

{

"tool": "assistantmail_list_messages", "input": { "mailboxId": " ", "limit": 20, "since": "2026-01-01T00:00:00.000Z" } }

{

"tool": "assistantmail_get_message", "input": { "mailboxId": " ", "messageId": " " } }

{

"tool": "assistantmail_send_email", "input": { "mailboxId": " ", "to": "recipient@example.com", "subject": "Hello", "text": "Hi there" } }

{

"tool": "assistantmail_reply_message", "input": { "mailboxId": " ", "messageId": " ", "text": "Thanks for the update." } }

If ASSISTANT_MAIL_API_KEY is set in the server environment, apiKey can be omitted from all tool inputs.

---

AssistantMail · Privacy Policy · Terms of Use