multimail

@multimail/mcp-server

まだ誰もエージェントにメールを任せていないため、エージェントはまだメールを使えません。MultiMail がそれを解決します。読み取り専用から完全な自律動作までの信頼レベルを備えた実際のメールアドレス、すべてのメッセージに付与される暗号学的な身元情報、宛先ごとの送信制御を提供します。

クイックスタート

{
  "mcpServers": {
    "multimail": {
      "type": "url",
      "url": "https://mcp.multimail.dev/mcp"
    }
  }
}

リモートサーバーです。インストールは不要です。初回接続時に OAuth で認証されます。

Claude.ai、Claude Desktop、Claude Code、Cursor、Windsurf、Copilot (VS Code)、ChatGPT Desktop、およびリモートサーバーに対応するあらゆる MCP クライアントで動作します。

別の方法：ローカル stdio サーバー

{
  "mcpServers": {
    "multimail": {
      "command": "npx",
      "args": ["-y", "@multimail/mcp-server"],
      "env": {
        "MULTIMAIL_API_KEY": "mm_live_...",
        "MULTIMAIL_MAILBOX_ID": "01KJ1NHN8J..."
      }
    }
  }
}

キーは multimail.dev で取得できます。キーを使わずに実行して、対話形式でアカウントを作成することもできます。

設定ファイルの場所

クライアント	設定ファイル
Claude Code	~/.claude/.mcp.json
Claude Desktop	claude_desktop_config.json
Cursor	プロジェクト内の .cursor/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json
Copilot (VS Code)	プロジェクト内の .vscode/mcp.json
OpenCode	プロジェクト内の mcp.json
ChatGPT Desktop	Settings > MCP Servers

信頼レベル

すべてのメールボックスには監視モードがあります。制限の厳しい設定から始め、エージェントが信頼を得るにつれて段階を上げます。

モード	動作
read_only	エージェントはメールを読み取ります。すべての送信がブロックされます。
gated_all	すべての操作に人間の承認が必要です。
gated_send	送信メールは承認まで保留されます。受信メールは即時に届きます。（デフォルト）
monitored	エージェントは自由に送信できます。コピーが監視用アドレスに送られます。
autonomous	送受信を完全に自律して行います。制限はありません。

エージェントは API 経由でモードの引き上げを申請します。運用者は一度限りのコードで承認します。引き下げに承認は不要です。エージェントはいつでも自ら制限を強化できます。

承認を伴うフローは Lean 4 で形式検証済みです。どのようなコードパスでも、運用者の承認を経ずにメールが配信されることはありません。

宛先ごとの許可リスト

gated_send モードでは、許可リストに登録された宛先は承認キューを通さずに送信できます。完全一致のアドレス（[email protected]）またはドメインのワイルドカード（*@example.com）を追加できます。追加するたびに運用者によるメール承認が必要です。エージェント自身が許可リストの変更を承認することはできません。

実用的な折衷案です。既知の連絡先との定型的なやり取りはすぐに送信され、新しい宛先への送信には引き続き監視が必要です。

暗号学的な身元情報

送信メールにはすべて、署名付きの X-MultiMail-Identity ヘッダー（ECDSA P-256）が付与されます。ペイロードには、運用者名、監視モード、機能、検証ステータスが含まれます。受信者は公開鍵を GET /.well-known/multimail-signing-key で照合します。

別の X-MultiMail-Reputation ヘッダーから、プライバシーを保護した評判データ（バウンス率、苦情率、アカウントの利用期間）にアクセスできます。生のアドレスは公開されません。

身元情報が検証されていなければ、受信者はエージェントとスパマーを見分けられません。身元情報があれば、受信者はメールを読む前に、運用者、監視レベル、送信履歴を検証できます。

エージェント DID リレー（任意）。 エージェントが did:key を MultiMail アカウントにバインドしている場合は、send_email / reply_email に任意の ucan パラメーターを渡します。MultiMail は、エージェントの自己署名 UCAN を変更せず、そのまま別の X-Agent-Identity ヘッダー（did="…"; ucan="…"）に中継します。署名や保証は行わず、受信側のツールが委任を個別に検証します。DID がバインドされていない場合は機能しません。

エージェントの自己登録（auth.md）

エージェントはブラウザーを使わずに登録できます。このプロトコルでは、WorkOS AuthKit に着想を得た auth.md の規約に従い、検証済みメールアドレスの本人確認を使用します。

POST /agent/auth -> claim_token + OTP sent to operator email
POST /agent/auth/claim/complete -> API key + tenant_id + granted scopes

検出には RFC 9728 を使用します。

• GET /.well-known/oauth-protected-resource（リソースメタデータ）
• GET /.well-known/oauth-authorization-server（agent_auth 拡張を含む認可メタデータ）
• GET /auth.md（人間とエージェントが読める登録ガイド）

401 レスポンスの WWW-Authenticate ヘッダーは、エージェントをこれらのエンドポイントへ自動的に誘導します。401 に遭遇したエージェントはリンクをたどり、登録プロトコルを読み、自ら登録手続きを完了できます。

コンテンツスキャン

送信メールはすべて、配信前にスキャンされます。メールは pending_scan ステータスになり、その後、配信または（ゲート付きモードでは）pending_send_approval に移行します。受信メールも同じパイプラインを通ります。フィッシング、マルウェア、プロンプトインジェクションのパターンは、エージェントの受信トレイに届く前に検出されます。

仕組み

• メール本文は markdown で入力し、整形済み HTML として出力します。受信した HTML は、クリーンな markdown として届きます（生の MIME と比べてトークン数が 15 分の 1）。
• スレッド化は自動です。メールに返信すると、ヘッダーが適切に設定されます。
• スキャン中の送信リクエストは pending_scan を返します。ゲート付きメールボックスでは、その後、人間による確認のために pending_send_approval に移行します。再試行しないでください。
• 送信メールにはすべて、暗号学的に署名された X-MultiMail-Identity ヘッダーが付与されます。
• 評判データは X-MultiMail-Reputation ヘッダーで提供されます。バウンス率、苦情率、アカウントの経過日数が含まれます。プライバシーを保護し、毎日更新されます。

ツール（50）

ツール	説明
メールの基本機能
send_email	Markdown 形式でメールを送信します。添付ファイル、idempotency_key、send_at による送信予約に対応しています。
check_inbox	ステータス、送信者、件名、期間、送受信方向、添付ファイル、ページネーションで絞り込んでメールを一覧表示します。
read_email	メールの全文を取得します。信頼できるメタデータと信頼できない本文は、別々のコンテンツブロックとして返されます。
reply_email	スレッド内で返信します。スレッド用ヘッダーは自動的に設定されます。
get_thread	会話スレッド内のすべてのメールと、参加者およびメタデータを取得します。
download_attachment	添付ファイルをコンテンツタイプ付きの Base64 形式でダウンロードします。
cancel_message	送信待ちまたは送信予約済みのメールをキャンセルします。
edit_scheduled_email	送信前の予約済みメールを編集します。
wait_for_email	条件に一致するメールが届くか、タイムアウトになるまで待機します（最大 120 秒）。
get_tags	メールに付いているすべてのタグを取得します。セッションをまたいで保持される、エージェント用のキーと値のメモリです。
set_tags	メールにタグを設定します。既存のタグと統合されます。
delete_tag	メールから特定のタグキーを削除します。
監督機能
list_pending	監督者の判断を待っているメールを一覧表示します（oversight スコープが必要です）。
decide_email	保留中のメールを承認または却下します（oversight スコープが必要です）。
manage_upgrade	監督モードのアップグレードを申請または適用します（アクション：request|apply）。
送信許可リスト
list_allowlist	送信許可リストのエントリを一覧表示します。
add_allowlist_entry	送信許可リストに受信者を追加します。オペレーターの承認が必要です。
remove_allowlist_entry	送信許可リストのエントリを削除します。
メールボックス管理
list_mailboxes	ID、アドレス、監督モード、表示名を含むすべてのメールボックスを一覧表示します。
configure_mailbox	初回セットアップを行います：監督モード、表示名、CC/BCC、送信予約、署名を設定します。
update_mailbox	設定（表示名、監督モード、署名、Webhook）を更新します。
create_mailbox	メールボックスを作成します（admin スコープとオペレーターの承認が必要です）。
delete_mailbox	メールボックスを完全に削除します（admin スコープが必要です）。
アカウントと請求
get_account	アカウントのステータス、プラン、クォータ、送信の有効状態、適用ティアを取得します。
update_account	組織名、監督者のメールアドレス、住所を更新します。
delete_account	アカウントとすべてのデータを完全に削除します（admin スコープが必要です）。
get_usage	請求期間のクォータと使用状況の統計を取得します。
upgrade_plan	有料プランにアップグレードします（Builder $9/月、Pro $29/月、Scale $99/月）。
cancel_subscription	有料サブスクリプションをキャンセルし、期間終了時にスタータープランに戻します。
get_billing_portal	請求をセルフサービスで管理するための Stripe ポータル URL を取得します。
サインアップ（API キー不要）
request_challenge	アカウント作成用の ALTCHA プルーフ・オブ・ワーク・チャレンジを要求します。
create_account	解決済みの PoW チャレンジを使ってアカウントを作成します。
resend_confirmation	新しいコードを記載した有効化メールを再送します。
activate_account	確認コードを使ってアカウントを有効化します。
setup_multimail	公開 /onboard エンドポイントでガイド付きオンボーディングを行います。
API キーと監査
list_api_keys	すべての API キーを一覧表示します（admin スコープが必要です）。
create_api_key	スコープを指定して API キーを作成します（admin スコープとオペレーターの承認が必要です）。自己承認を防ぐため、send+oversight は拒否されます。
revoke_api_key	API キーを無効化します（admin スコープが必要です）。
get_audit_log	アカウントの監査ログを取得します（admin スコープが必要です）。
連絡先とスパム
search_contacts	名前またはメールアドレスで連絡先を検索します。
add_contact	連絡先を追加します。
delete_contact	連絡先を削除します。
manage_spam_status	スパムを報告するか、スパム状態を解除します（アクション：report|clear）。
list_spam	スパムとしてフラグ付けされたメールと隔離されたメールを一覧表示します。
list_suppression	配信抑止対象の受信者をページネーション付きで一覧表示します。
remove_suppression	配信抑止リストから受信者を削除します。
Webhook
create_webhook	メールイベントのリアルタイム通知用に Webhook を作成します。
list_webhooks	すべての Webhook を一覧表示します。
delete_webhook	Webhook を削除します。
その他
report_issue	バグ、サイトの問題、機能リクエストを報告します。

プロンプトの例

Find the most recent email from [email protected], summarize what she's asking,
then draft a reply saying I'll review this week. Don't send until I approve.

Check my inbox and summarize the last 5 unread emails.
For each: sender, subject, time, and whether it needs action today.

Review the pending approval queue. For each pending email: who it goes to,
the subject, risk factors, and whether to approve or reject.

Show my current sending allowlist. Then add *@acme.com so emails to Acme skip approval.

環境変数

変数	必須	説明
MULTIMAIL_API_KEY	stdio モードでは必須	API キー（mm_live_...）です。リモートサーバーでは不要です（OAuth を使用します）。
MULTIMAIL_MAILBOX_ID	いいえ	デフォルトのメールボックス ID です。設定されていない場合は、各ツールに mailbox_id を渡すか、list_mailboxes を呼び出してください。
MULTIMAIL_API_URL	いいえ	API のベース URL です。デフォルトは https://api.multimail.dev です。

こちらも利用できます

• REST API：https://api.multimail.dev（OpenAPI 仕様）
• CLI：npx -y @mvanhorn/printing-press install multimail（すべての API エンドポイントをシェルコマンドとして利用できます）
• SDK：Python、Vercel AI SDK、LangChain、LlamaIndex、CrewAI、AutoGen

開発

npm install
npm run dev   # Run with tsx
npm run build # Compile TypeScript
npm start     # Run compiled version

ライセンス

MIT

MultiMail を使用することで、利用規約および許容される使用に関するポリシーに同意したものとみなされます。