Assistant Mail MCP

io.github.AssistantMail由 GitHub 账号 AssistantMail 发布v1.3.1更新于 Oct 24, 2026

Agent email with allowlist and consent via AssistantMail.

已验证STDIO仅桌面效率与工作流沟通与协作

概览

AI 生成的概览

为 AI 助手提供一个受管的 AssistantMail 邮箱，可在账户级白名单与同意规则下发送、读取、回复和删除邮件。

可以做什么
将助手连接到 AssistantMail 服务，使其能够列出和创建邮箱、列出并获取收发邮件、排队发送外发邮件、回复已有邮件，以及删除邮件或整个邮箱。它还能管理收件人（已批准与待批准）、读取和更新入站策略，并查询每日和每月的发送配额用量。另有若干参考工具返回原始 REST 端点信息，而不实际调用 API。
适用场景
当助手需要自己的邮件身份，代表个人或小团队收发邮件，并由账户控制白名单、同意、保留期和支出上限时，值得添加。若只是读取已有的个人邮箱，则用处不大，因为这是独立的受管邮箱服务。
运行要求
通过 npx 以 stdio 在本地运行（需要 Node 24+）。需要 AssistantMail 账户和 API 密钥（amk_...），通过 ASSISTANT_MAIL_API_KEY 环境变量或每次工具调用传入；可选的 ASSISTANT_MAIL_API_BASE_URL 用于覆盖默认 API 地址。需要能访问 AssistantMail API 的网络。
安装前请注意
API 密钥属于机密，创建时只显示一次，应放在环境变量中而非共享配置里。删除邮箱会永久移除该邮箱及其全部邮件且没有确认步骤，删除邮件工具也可清空整个邮箱。发送邮件和添加收件人会联系第三方，添加收件人可能触发一封同意邀请邮件。付费套餐在应用内升级，会产生费用。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Assistant Mail MCP，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

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

bash
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

bash
npx -y @assistantmail/assistantmail-mcp

Node 24+.

Claude Desktop

json
{  "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)

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

VariableDefaultDescription
ASSISTANT_MAIL_API_KEY(none)API key (amk_...). Can be omitted if passed per-tool.
ASSISTANT_MAIL_API_BASE_URLhttps://api.assistant-mail.aiThe public API for the AssistantMail service

Tools

Diagnostics

ToolDescription
assistantmail_healthCheck that the MCP server is running and confirm the API base URL. No API key required.

Account

ToolDescription
assistantmail_get_meGet account profile and plan tier.
assistantmail_get_inbound_policyGet the current inbound email policy (who can send to this account's mailboxes).
assistantmail_update_inbound_policyUpdate the inbound policy (if allowed by selected account tier). Accepted values: owner, list, sent. Use allowedSenders with list.

Mailboxes

ToolDescription
assistantmail_list_mailboxesList all mailboxes on the account. Returns mailboxId needed for message operations.
assistantmail_create_mailboxCreate a new mailbox (if allowed by selected account tier), optionally specifying displayName and address.
assistantmail_get_mailboxGet metadata for a single mailbox by mailboxId.
assistantmail_update_mailboxUpdate a mailbox's display name.
assistantmail_delete_mailboxPermanently delete a mailbox and all its messages. THIS ACTION HAS NO CONFIRMATION. USE CAREFULLY.

Messages

ToolDescription
assistantmail_list_messagesList inbound and outbound messages for a mailbox. Supports since (ISO timestamp) and limit (max 100).
assistantmail_get_messageFetch a single message including textBody and htmlBody. Bodies are only returned within the plan's retention window; bodyExpired: true is set if the window has elapsed.
assistantmail_send_emailQueue an outbound email. Requires to, subject, and at least one of text or html.
assistantmail_reply_messageReply to an existing message. Requires messageId and at least one of text or html; recipients and subject are derived automatically.
assistantmail_delete_messagesDelete messages by messageIds array, or pass deleteAll: true to clear the mailbox.
assistantmail_get_usageGet daily and monthly send quota usage for a mailbox. A null limit means unlimited.

Recipients

ToolDescription
assistantmail_list_recipientsList approved and pending recipients for the account.
assistantmail_add_recipientAdd a recipient. Sends a consent invitation email when required by the account's plan.
assistantmail_remove_recipientRemove a recipient from the allowed list.

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.

ToolDescription
assistantmail_send_email_referenceEndpoint, headers, and body fields for POST /v1/mailboxes/{mailboxId}/messages.
assistantmail_list_messages_referenceEndpoint and query params for GET /v1/mailboxes/{mailboxId}/messages.
assistantmail_get_message_referenceEndpoint and response schema for GET /v1/mailboxes/{mailboxId}/messages/{messageId}.
assistantmail_get_usage_referenceEndpoint and response schema for GET /v1/mailboxes/{mailboxId}/usage.

Quick start

bash
API_KEY="amk_..."BASE="https://api.assistant-mail.ai"
# 1) Discover your mailboxIdcurl "$BASE/v1/mailboxes" -H "x-api-key: $API_KEY"
# 2) Send an emailcurl -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 inboxcurl "$BASE/v1/mailboxes/<mailboxId>/messages" -H "x-api-key: $API_KEY"

Tool call examples

json
{ "tool": "assistantmail_list_mailboxes", "input": { "apiKey": "amk_..." } }
json
{  "tool": "assistantmail_list_messages",  "input": { "mailboxId": "<uuid>", "limit": 20, "since": "2026-01-01T00:00:00.000Z" }}
json
{  "tool": "assistantmail_get_message",  "input": { "mailboxId": "<uuid>", "messageId": "<uuid>" }}
json
{  "tool": "assistantmail_send_email",  "input": {    "mailboxId": "<uuid>",    "to": "[email protected]",    "subject": "Hello",    "text": "Hi there"  }}
json
{  "tool": "assistantmail_reply_message",  "input": {    "mailboxId": "<uuid>",    "messageId": "<uuid>",    "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

来源：README.md，提交 16a3f92

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.3.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分