AgentMail MCP Server

AgentMail MCP Server とは？

AgentMail MCP サーバーは AgentMail 公式のホスト型エンドポイント（https://mcp.agentmail.to/mcp）で、AI アシスタントがメールの受信箱を作成し、エージェントの代わりにメールを送信・閲覧・返信・検索できるようにします。

AgentMail は AI エージェントのために作られたメールプロバイダーです。人間のメールボックスを共有する代わりに、各エージェントが REST API で自分専用の受信箱を持てます。スレッド、リアルタイムイベント用の Webhook と WebSocket、DKIM・SPF・DMARC 対応のカスタムドメイン、IMAP と SMTP によるアクセス、Python と TypeScript の SDK を備えています。ホスト型 MCP サーバーはこの受信箱 API を Claude、ChatGPT、Cursor などの MCP クライアントに公開するため、アシスタントがメールのワークフローを最初から最後まで実行できます。

AgentMail MCP Server の使い方

AgentMail のアカウント（console.agentmail.to）が必要です。認証方法は 2 つあります。

• OAuth（既定）：Claude Desktop、claude.ai、ChatGPT に推奨されます。クライアントが console.agentmail.to でのサインインに案内し、サーバーはあなたのコンソール ID として動作します。API キーは不要です。
• API キー：Cursor、Windsurf など MCP OAuth に対応していないクライアント向けです。コンソールの Settings > API Keys でキーを作成し、x-api-key ヘッダーで送信します。AgentMail は、URL のクエリ文字列にキーを入れるとログや履歴に残るため避けるよう注意しています。

Claude Code

AgentMail のドキュメントに記載されたコマンドです。初回使用時にブラウザで OAuth サインインが行われます。

claude mcp add --transport http agentmail https://mcp.agentmail.to/mcp

claude.ai で追加したコネクターは Claude Code には同期されないため、別途追加してください。OAuth の代わりに API キーを使う場合は次のとおりです。

claude mcp add --transport http agentmail https://mcp.agentmail.to/mcp --header "x-api-key: ${AGENTMAIL_API_KEY}"

Claude Desktop と claude.ai

Settings > Connectors > Add custom connector を開きます。名前を AgentMail、URL を https://mcp.agentmail.to/mcp として Add をクリックし、続けて Connect をクリックします。console.agentmail.to でサインインし、複数の組織がある場合は 1 つを選んで、「List my AgentMail inboxes.」で動作を確認します。

Cursor

Cursor の MCP 設定（~/.cursor/mcp.json）に、x-api-key ヘッダー付きでサーバーを追加します。

{
  "mcpServers": {
    "agentmail": {
      "url": "https://mcp.agentmail.to/mcp",
      "headers": {
        "x-api-key": "${AGENTMAIL_API_KEY}"
      }
    }
  }
}

VS Code

.vscode/mcp.json にサーバーを追加します。接続時に VS Code がブラウザで OAuth サインインを開きます。

{
  "servers": {
    "agentmail": {
      "type": "http",
      "url": "https://mcp.agentmail.to/mcp"
    }
  }
}

カスタムヘッダーも OAuth も使えないクライアントの場合は、AgentMail の agentmail-mcp GitHub リポジトリにある stdio 互換ブリッジを使えます。これは環境変数から AGENTMAIL_API_KEY を読み取ります。

AgentMail MCP Server の主な機能

• 公式のホスト型サーバー。リモートの Streamable HTTP サーバーに対応したクライアントならローカルへのインストールは不要です。
• AgentMail コンソールでの組織選択付き OAuth サインイン、または x-api-key ヘッダー。
• AgentMail のドキュメントには 43 個のツールと、OAuth セッション専用の組織ツール 2 個が記載されています。
• 受信箱のライフサイクル全体：受信箱の一覧、検索、作成、更新、削除、認可。
• スレッド、メッセージ、下書き：スレッドの検索と閲覧、メッセージの送信・返信・転送、下書きの作成・更新・送信、添付ファイルの取得。
• エージェントにメールを送れる相手を制御する許可リストとブロックリスト。
• Agent Drive のファイル保存と、Firecrawl などのサービスでエージェント用アカウントを作成する AgentID ツール。サインインリンクは 1 回限りで、5 分で失効します。
• メタデータのみを含む MCP イベント message.received。アシスタントはそのあと get_message でメッセージ全体を読み取ります。

AgentMail MCP Server のユースケース

• サポート用エージェントに専用アドレスを与える：「support-bot という AgentMail の受信箱を作成して、アドレスを教えて」
• 受信メールの仕分け：「AgentMail の受信箱から請求書に関する未読スレッドを探して要約して」
• 文脈を踏まえた返信：「onboarding スレッドの最新メッセージに返信して、会議の時間を確定して」
• 確認用の下書き：「今週営業用の受信箱にメールをくれた全員へのフォローアップを下書きして。まだ送信しないで」
• エージェントのツール登録：「AgentID を使ってこのエージェントの Firecrawl アカウントを作成して」
• 受信箱の整理：「support-bot の受信箱で、このドメインからのメールをブロックして」

AgentMail MCP Server のトラブルシューティング

• 「Unauthorized」（401）：クライアントが OAuth もキーもなしで接続しています。ブラウザでのサインインを完了するか、x-api-key ヘッダーを追加してください。
• claude.ai では使えるのに Claude Code では使えない：claude.ai のコネクターは Claude Code に同期されません。claude mcp add でサーバーを追加してください。
• クライアントがヘッダーを送れず OAuth も使えない：agentmail-mcp GitHub リポジトリの stdio 互換ブリッジを使い、環境変数で AGENTMAIL_API_KEY を渡してください。
• キーがログに残っている：クエリパラメーターとして渡しています。x-api-key ヘッダーで送るように変更し、キーをローテーションしてください。