Multi Gmail Account MCP

Multi Gmail Account MCP

Claude からすべてのメールボックスを一度に使えます。 この MCP サーバーは、任意の数の Gmail アカウントと IMAP アカウントに接続できます。そのため、「すべてのアカウントで未読のメールは？」、「返信しなければならない相手は誰？」、「ショップの受信トレイに仕入先から届いた請求書を読んで」といった質問ができます。Claude はすべてのメールボックスをまとめて検索し、各メールがどのアカウントから届いたかを伝えます。

このツールの特長

	このサーバー	Claude に組み込まれた Gmail	一般的な Gmail MCP
アカウント数	Gmail + IMAP、無制限	1	通常は1つ、または呼び出しごとに1つ
すべての受信トレイを一度に検索	はい。統合して重複を除去します	いいえ	まれ
複数アカウントを横断して「返信を待っている相手は？」を確認	はい	いいえ	いいえ
添付ファイル内のPDF、Word、Excel、画像を読む	はい	一部対応	まれ
許可がない限り送信しない	デフォルト（下書きモード）	送信ごとに確認	通常は自由に送信
ログイン情報を暗号化し、すべての操作を監査ログに記録	はい	該当なし	まれ
claude.ai のウェブ版とモバイル版で動作	ホストモード	はい	まれ

機能

• 複数アカウントを前提に設計：
  • メールボックスにエイリアス（shop、work、personal）を付けられます。
  • すべてのメールボックスを一度に検索、要約、優先順位付けしたり、1つを選んだりできます。
  • 2つのアカウントに同じメールがある場合は、1回だけ表示します。
• 優先順位付け：
  • needs_reply は、あなたからの返信を待っているスレッドを古い順に表示します。
  • daily_digest と /morning-digest プロンプトで概要を確認できます。
  • /reply-queue は、1件ずつ返信の下書きを作成します。
• 添付ファイル： PDF（ページ範囲、スキャンページ）、DOCX、XLSX、PPTX、ODT/ODS、RTF、CSV/HTML、.eml、ZIP を保存せずに読み取れます。また、画像もClaudeに確認させることができます（ギリシャ語も含むOCRに対応）。
• 下書きとして作成：
  • スレッドへの返信と全員への返信
  • 元の添付ファイルを含む転送
  • Gmail の メール送信元 アドレスと署名
  • ローカルファイルの添付
• 整理：
  • ニュースレターのレポートと配信停止
  • プレビューを必ず表示したうえで、複数メールを一括アーカイブ／既読にする／ラベル付け／ゴミ箱に移動
  • ラベルとフィルター
• カレンダー（オプション）： すべてのアカウントの予定、すべてのカレンダーを横断した空き時間の確認、予定の作成に対応します。
• IMAP： Gmail と同じ検索構文で、あらゆるメールボックス（Hetzner、cPanel、Fastmail など）を Gmail と並べて利用できます。
• 安全性：
  • 3つのモード（readonly、送信しない drafts、full）とアカウントごとの制限
  • ログイン情報を暗号化（OS キーチェーン）
  • 監査ログ
  • 誤ったアカウントからのサインインを拒否
  • 読み取り時のみ再試行
• ホストモード： 小規模なサーバー上で Docker を使って実行し、カスタムコネクター（OAuth 2.1、パスワード保護）として claude.ai に追加できます。

ツールは全部で33種類あります。ツールのリファレンス をご覧ください。

スクリーンショット

返信待ち： すべての受信トレイであなたからの返信を待っている相手を、古い順に表示します。	添付ファイル： PDF、Office ファイル、画像の内容について質問できます。
デフォルトは下書きのみ： フルモードに切り替えない限り、送信も削除もされません。	Gmail と IMAP を並べて表示し、それぞれに名前を付けられます。

クイックスタート

npm install -g multi-gmail-account-mcp

1. Google OAuth クライアント（一度だけ）： Google Cloud プロジェクトを作成し、Gmail API を有効にして、アプリを 外部 かつ 本番環境 に設定します。デスクトップアプリ クライアントを作成し、その JSON を ~/.gmail-mcp/oauth-keys.json として保存します。手順ガイド。

2. アカウントを接続：

   gmail-mcp-multi auth shop [email protected]
   gmail-mcp-multi auth work [email protected] --calendar
   gmail-mcp-multi add-imap company [email protected] --host mail.example.com   # optional IMAP mailbox
   gmail-mcp-multi default shop
   gmail-mcp-multi doctor
   

3. Claude Desktop に追加（設定 → 開発者 → 設定を編集）し、Claude を再起動します。

   {
     "mcpServers": {
       "gmail-multi": { "command": "npx", "args": ["-y", "multi-gmail-account-mcp", "--mode", "drafts"] }
     }
   }
   

   Claude Code：claude mcp add gmail-multi -- npx -y multi-gmail-account-mcp --mode drafts

4. Claude に依頼：

   • 朝のブリーフィング。（または /morning-digest）
   • 返信しないといけない相手は誰ですか？
   • すべてのアカウントから10月のDHLの請求書を探して、合計金額を確認してください。
   • Maria に、注文品は木曜日に発送されるとギリシャ語で返信する下書きを作成してください。

モード

モード	Claude ができること
readonly	検索、閲覧、要約、添付ファイルの閲覧
drafts (デフォルト)	上記に加え、下書き、下書きとしての転送、ラベルの操作、既読／未読の切り替え、アーカイブ、プレビュー付きの一括アーカイブ。メールが送信されることはありません。
full	上記に加え、送信、ゴミ箱への移動、配信停止、フィルター、カレンダーイベントの作成

--mode で選択します。gmail-mcp-multi limit <alias> readonly で単一のアカウントに制限できます。詳細：セキュリティ。

ドキュメント

セットアップ	インストール、Google Cloud、アカウントの接続、Claude Desktop／Code
日常的な使い方	タスク別に、Claude に依頼できること
アカウント	エイリアス、デフォルト、複数アカウントの動作、アカウントごとの制限
IMAP アカウント	Gmail 以外のメールボックス（Hetzner、cPanel…）
添付ファイル	閲覧できる内容と制限
カレンダー	有効化、空き時間の検索、イベント
ホストモード	Docker + Caddy 経由の claude.ai ウェブ版とモバイル版
セキュリティとプライバシー	モード、暗号化、監査ログ、プロンプトインジェクション、ローカルファイル
設定	CLI コマンド、環境変数、ファイル
トラブルシューティング	よくあるエラーと解決方法
ツールリファレンス	すべてのツールとパラメーター（自動生成）
開発	アーキテクチャ、テスト、リリース

クレジット

Elle Morrill による dmorrill/gmail-mcp-multi からのフォークです。このフォークには、上流のコミュニティからのプルリクエストが統合されています。

• Dave Moudy： 認証情報ファイルの保護、インストール手順（#15）
• Vadim Zaliva： アカウントごとの OAuth クライアント、スタンドアロン認証、読み取り専用への切り替え（#13）
• Bobby Marko： 添付ファイル、RFC 2047 の件名、ラベルとフィルター（#9、#10、#11）
• 添付ファイルのダウンロード（#14）

Antonis Papamichail（psdgator）がメンテナンスしています。貢献を歓迎します。CONTRIBUTING.md をご覧ください。

MIT ライセンスです。プライバシー：PRIVACY.md。