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 分