Assistant Mail MCP

assistantmail-mcp

AssistantMail 向けの MCP サーバーです。AI エージェントに、メールの送受信に使える管理されたメールボックスを提供します。

許可リスト、同意、保持期間、利用上限を自分で管理しながらエージェントにメールを使わせたい、個人や小規模チームの OpenClaw / Hermes 運用者向けに作られています。簡単にインストールできるよう 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 つ、1 日あたり 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

Official MCP Registry

io.github.AssistantMail/assistantmail-mcp として、Official MCP Registry に掲載済みです。製品ドキュメント：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	メールボックスの1日および1か月あたりの送信クォータ使用量を取得します。上限が null の場合は無制限です。

受信者

ツール	説明
assistantmail_list_recipients	アカウントで承認済みおよび保留中の受信者を一覧表示します。
assistantmail_add_recipient	受信者を追加します。アカウントのプランで必要な場合は、同意を求める招待メールを送信します。
assistantmail_remove_recipient	許可リストから受信者を削除します。

リファレンスツール

これらのツールは API を呼び出すのではなく、REST エンドポイントの詳細をそのまま返します。リクエストを手動で作成する場合や、正確な 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 · プライバシーポリシー · 利用規約