Assistant Mail MCP

assistantmail-mcp

适用于 AssistantMail 的 MCP 服务 — 为 AI Agent 提供托管邮箱，用于收发邮件。

专为个人和小型团队的 OpenClaw / Hermes 操作者打造，让你能够控制 Agent 邮件的允许列表、授权、保留期限和支出上限。已在 ClawHub 上架，方便安装 — 这并非 OpenClaw 官方背书。

免费获取 · 文档 · 网站 · 隐私政策 · 条款 · 参与贡献

OpenClaw / ClawHub

openclaw skills install @assistantmail/assistant-mail

然后配置 MCP 客户端以运行此服务，并设置 ASSISTANT_MAIL_API_KEY（下方提供 Claude Desktop 和 Cursor 示例）。技能：ClawHub 上的 assistant-mail。同一个 MCP 也适用于 Hermes。

安装

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 或 .vscode/mcp.json）

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

前提条件

1. 通过上方的免费获取链接创建免费账户（1 个 Agent，每天 25 封；当前限额：文档）。
2. 前往 API Keys 并创建一个密钥（amk_...）。请立即复制 — 密钥只显示一次。
3. 设置 ASSISTANT_MAIL_API_KEY；调用 assistantmail_list_mailboxes 获取 mailboxId UUID。邮件 API 路由使用此 UUID，而非电子邮件地址。

付费套餐：仅可在应用内升级（不通过 Payment Links）。在 AssistantMail 应用中使用 Upgrade — 结账不通过 Stripe Payment Links 提供。文档：assistant-mail.ai/docs

官方 MCP Registry

此条目已在官方 MCP Registry 上线，名称为 io.github.AssistantMail/assistantmail-mcp。产品文档：assistant-mail.ai/docs。

打包配置位于 server.json。版本号更新后，使用 mcp-publisher 重新发布 — 参阅 docs/MCP_REGISTRY.md。

环境变量

变量	默认值	描述
ASSISTANT_MAIL_API_KEY	(无)	API 密钥（amk_...）。如果按工具传入，则可省略。
ASSISTANT_MAIL_API_BASE_URL	https://api.assistant-mail.ai	AssistantMail 服务的公共 API

工具

诊断

工具	描述
assistantmail_health	检查 MCP 服务是否正在运行，并确认 API 基础 URL。无需 API 密钥。

账户

工具	描述
assistantmail_get_me	获取账户资料和套餐级别。
assistantmail_get_inbound_policy	获取当前的收件邮件策略（谁可以向此账户的邮箱发送邮件）。
assistantmail_update_inbound_policy	更新收件策略（需所选账户套餐允许）。可接受的值：owner、list、sent。与 list 搭配使用 allowedSenders。

邮箱

工具	描述
assistantmail_list_mailboxes	列出账户中的所有邮箱。返回邮件操作所需的 mailboxId。
assistantmail_create_mailbox	创建新邮箱（需所选账户套餐允许），可选指定 displayName 和 address。
assistantmail_get_mailbox	根据 mailboxId 获取单个邮箱的元数据。
assistantmail_update_mailbox	更新邮箱的显示名称。
assistantmail_delete_mailbox	永久删除邮箱及其所有邮件。此操作不会要求确认。请谨慎使用。

消息

工具	描述
assistantmail_list_messages	列出邮箱的收件和发件消息。支持 since（ISO 时间戳）和 limit（最多 100）。
assistantmail_get_message	获取单条消息，包括 textBody 和 htmlBody。只有在套餐的保留期限内才会返回正文；如果期限已过，则会设置 bodyExpired: true。
assistantmail_send_email	将外发邮件加入队列。需要提供 to、subject，以及 text 或 html 中至少一项。
assistantmail_reply_message	回复现有消息。需要提供 messageId，以及 text 或 html 中至少一项；收件人和主题会自动生成。
assistantmail_delete_messages	根据 messageIds 数组删除消息，或传入 deleteAll: true 清空邮箱。
assistantmail_get_usage	获取邮箱的每日和每月发送配额用量。null 限额表示无限制。

收件人

工具	描述
assistantmail_list_recipients	列出账户中已批准和待处理的收件人。
assistantmail_add_recipient	添加收件人。如果账户套餐有此要求，则会发送同意邀请邮件。
assistantmail_remove_recipient	从允许列表中移除收件人。

参考工具

这些工具返回原始 REST 端点详情，而不调用 API。需要手动构造请求或查看确切的 URL 和响应架构时，请使用这些工具。

工具	描述
assistantmail_send_email_reference	POST /v1/mailboxes/{mailboxId}/messages 的端点、标头和正文参数。
assistantmail_list_messages_reference	GET /v1/mailboxes/{mailboxId}/messages 的端点和查询参数。
assistantmail_get_message_reference	GET /v1/mailboxes/{mailboxId}/messages/{messageId} 的端点和响应架构。
assistantmail_get_usage_reference	GET /v1/mailboxes/{mailboxId}/usage 的端点和响应架构。

快速开始

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/<mailboxId>/messages" \
  -H "x-api-key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":"[email protected]","subject":"Hello","text":"Hi there"}'

# 3) Read inbox
curl "$BASE/v1/mailboxes/<mailboxId>/messages" -H "x-api-key: $API_KEY"

工具调用示例

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

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

{
  "tool": "assistantmail_get_message",
  "input": { "mailboxId": "<uuid>", "messageId": "<uuid>" }
}

{
  "tool": "assistantmail_send_email",
  "input": {
    "mailboxId": "<uuid>",
    "to": "[email protected]",
    "subject": "Hello",
    "text": "Hi there"
  }
}

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

如果服务器环境中设置了 ASSISTANT_MAIL_API_KEY，则所有工具输入都可以省略 apiKey。

---

AssistantMail · 隐私政策 · 使用条款