@multimail/mcp-server

MultiMail 用のMCPサーバーです。エージェントに独自のメールアドレスを与え、完全な承認から自律的な送信まで、段階的な人間による監視を実現します。

クイックスタート

npx @multimail/mcp-server

フルアクセスには MULTIMAIL_API_KEY を設定してください。設定なしで実行すると、まずアカウント作成が求められます。キーは multimail.dev で取得できます。

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

Related MCP server: MCP Email Server

セットアップ

オプションA: リモートサーバー（推奨）

インストールは不要です。ホストされているサーバーに直接接続します。ブラウザでのOAuth経由で認証します。

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

Claude.ai、Claude Desktop、Claude Code、およびリモートMCPサーバーをサポートするすべてのクライアントで動作します。

オプションB: ローカルサーバー（stdio）

サーバーをローカルで実行します。APIキーは環境変数として渡されます。

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

追加場所

クライアント	設定ファイル
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	設定 > MCPサーバー
その他のMCPクライアント	クライアントのドキュメントで設定場所を確認してください

環境変数

変数	必須	説明
`MULTIMAIL_API_KEY`	はい	MultiMail APIキー (`mm_live_...`)
`MULTIMAIL_MAILBOX_ID`	いいえ	デフォルトのメールボックスID。設定しない場合は、各ツールに `mailbox_id` を渡すか、先に `list_mailboxes` を呼び出してください。
`MULTIMAIL_API_URL`	いいえ	APIベースURL。デフォルトは `https://api.multimail.dev` です。

初回セットアップ

初回使用時に、MultiMailはメールボックスの設定を促します。configure_mailbox ツールを使用して明示的に実行することも可能です：

監視モード: 人間による承認の必要度 (gated_send, monitored, autonomous など)
表示名: メールに表示される送信者名
CC/BCCデフォルト: すべての送信メールに自動的にコピーするアドレス
スケジュール: 送信予約の有効/無効化およびデフォルトのゲートタイミング設定
署名: メールの署名ブロック

この手順をスキップした場合、最初のツール呼び出し時にMultiMailが通知します。

ツール

ツール	説明
`list_mailboxes`	このAPIキーで利用可能なすべてのメールボックスを一覧表示
`configure_mailbox`	メールボックス設定（監視モード、表示名、CC/BCC、スケジュール、署名）を設定
`send_email`	Markdown本文でメールを送信。添付ファイル、`idempotency_key`、予約送信用の `send_at` をサポート
`check_inbox`	ステータス、送信者、件名、日付範囲、方向、添付ファイル、カーソルページネーションでフィルタリングしてメールを一覧表示
`read_email`	メールの全内容を取得。信頼されたメタデータと信頼できない本文を別々のコンテンツブロックとして返します
`reply_email`	既存のスレッド内のメールに返信。添付ファイルと `idempotency_key` をサポート
`download_attachment`	メール添付ファイルをコンテンツタイプ付きのbase64としてダウンロード
`get_thread`	参加者とメタデータを含む会話スレッド内のすべてのメールを取得
`cancel_message`	保留中または予約済みのメールをキャンセル
`schedule_email`	`send_at` 時間を指定して将来の送信を予約。送信前に編集またはキャンセル可能
`edit_scheduled_email`	送信前に予約済みメールの配信時間、宛先、件名、または本文を編集
`update_mailbox`	メールボックス設定（表示名、監視モード、署名、Webhook）を更新
`update_account`	アカウント設定（組織名、監視用メールアドレス、住所）を更新
`delete_mailbox`	メールボックスを完全に削除（管理者スコープが必要）
`request_challenge`	アカウント作成用のALTCHAプルーフ・オブ・ワークチャレンジを要求（APIキー不要）
`create_account`	解決済みのPoWチャレンジで新しいアカウントを作成（APIキー不要）
`resend_confirmation`	新しいコードで確認メールを再送（APIキー不要）
`activate_account`	確認メールのコードを使用してアカウントを有効化（APIキー不要）
`tag_email`	メールにキーバリュータグを設定、取得、削除（エージェントの永続メモリ）
`add_contact`	オプションのタグを付けて連絡先をアドレス帳に追加
`search_contacts`	名前またはメールアドレスでアドレス帳を検索
`get_account`	アカウントステータス、プラン、クォータ、送信有効化状態、強制ティアを取得
`create_mailbox`	新しいメールボックスを作成（管理者スコープが必要）
`request_upgrade`	監視モードのアップグレードを要求（信頼ラダー）
`apply_upgrade`	オペレーターからのアップグレードコードを適用
`get_usage`	請求期間のクォータと使用状況統計を確認
`list_pending`	監視判断待ちのメールを一覧表示（監視スコープが必要）
`decide_email`	保留中のメールを承認または拒否（監視スコープが必要）
`delete_contact`	アドレス帳から連絡先を削除
`check_suppression`	サプレスされたメールアドレスを一覧表示
`remove_suppression`	サプレスリストからアドレスを削除
`list_api_keys`	すべてのAPIキーを一覧表示（管理者スコープが必要）
`create_api_key`	スコープ付きの新しいAPIキーを作成（管理者スコープ+オペレーター承認が必要。自己承認を防ぐため `send`+`oversight` の組み合わせは拒否されます）
`revoke_api_key`	APIキーを取り消し（管理者スコープが必要）
`get_audit_log`	アカウント監査ログを取得（管理者スコープが必要）
`delete_account`	アカウントとすべてのデータを完全に削除（管理者スコープが必要）
`wait_for_email`	フィルタに一致する新しいメールが届くか、タイムアウト（最大120秒）するまでブロック
`create_webhook`	リアルタイムのメールイベント通知用のWebhookサブスクリプションを作成
`list_webhooks`	このアカウントのすべてのWebhookサブスクリプションを一覧表示
`delete_webhook`	Webhookサブスクリプションを削除

仕組み

メール本文は Markdown で記述します。MultiMailは配信のためにフォーマットされたHTMLに変換します。
受信メールは クリーンなMarkdown として届きます。HTML解析やMIMEデコードは不要です。
スレッド化は自動です。メールに返信するとヘッダーが正しく設定されます。
送信は、脅威スキャン中に pending_scan ステータスを返します。メールボックスがゲート監視を使用している場合、ステータスは人間によるレビューのために pending_send_approval に移行します。再試行や再送は行わないでください。
受信メールの X-MultiMail-Identity 署名済みヘッダーを確認して、他のエージェントを検証してください。

開発

npm install
npm run dev   # Run with tsx (no build needed)
npm run build # Compile TypeScript
npm start     # Run compiled version

テスト

echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | MULTIMAIL_API_KEY=mm_live_... node dist/index.js

ライセンス

MIT

MultiMail

@multimail/mcp-server

クイックスタート

セットアップ

オプションA: リモートサーバー（推奨）

オプションB: ローカルサーバー（stdio）

追加場所

環境変数

初回セットアップ

ツール

仕組み

開発

テスト

ライセンス

Resources

Tools

Latest Blog Posts

MCP directory API