multi-gmail-mcp

multi-gmail-mcp

Claude Desktop で複数の Gmail アカウントを同時に管理できる、Model Context Protocol（MCP）サーバーです。Anthropic 公式 MCP レジストリに掲載され、npm で公開されています。

---

機能

• 無制限の Gmail アカウントに接続できます — 個人用、仕事用、サイドプロジェクト用
• Gmail の検索構文を使って、あらゆる受信トレイを検索できます
• MIME パースを使って、メール全体を読み取れます
• メールの送信、スレッドへの返信、下書きの作成ができます
• ラベルで整理できます：追加、削除、一覧表示、アーカイブ
• 既読／未読に設定できます
• トークンはローカルの ~/.gmail-mcp-tokens.db に保存されます — Git にコミットされることはありません
• OAuth トークンを自動でサイレント更新します

---

要件

• Node.js >= 22.5.0
• Gmail API を有効にした Google Cloud プロジェクト
• Claude Desktop

---

インストール

npm install -g multi-gmail-mcp

グローバルコマンドが 2 つ登録されます：gmail-mcp（MCP サーバー）と gmail-mcp-cli（アカウントマネージャー）です。

---

Google Cloud の設定

この手順は一度だけ行います。

1. console.cloud.google.com にアクセスし、プロジェクトを作成します
2. Gmail API を有効にします（API とサービス → ライブラリ）
3. OAuth 同意画面を設定します — 外部を選択し、テストユーザーとして Gmail アドレスを追加します
4. スコープを追加します：gmail.readonly、gmail.send、gmail.modify、gmail.labels
5. デスクトップアプリの OAuth 認証情報を作成し、JSON をダウンロードします
6. ~/.gmail-mcp-oauth.json に保存します

または、Claude Desktop の設定で環境変数を設定します（以下を参照）。

---

Gmail アカウントの認証

# Add accounts (opens browser for Google sign-in)
gmail-mcp-cli add [email protected]
gmail-mcp-cli add [email protected]

# List authenticated accounts
gmail-mcp-cli list

# Remove an account
gmail-mcp-cli remove [email protected]

トークンは ~/.gmail-mcp-tokens.db に保存され、自動的に更新されます。

---

Claude Desktop の設定

~/Library/Application Support/Claude/claude_desktop_config.json を編集します：

{
  "mcpServers": {
    "multi-gmail": {
      "command": "gmail-mcp"
    }
  }
}

~/.gmail-mcp-oauth.json の代わりに環境変数を使う場合：

{
  "mcpServers": {
    "multi-gmail": {
      "command": "gmail-mcp",
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

保存後、Claude Desktop を再起動します。ハンマーアイコンをクリックして、19 個のツールが読み込まれていることを確認します。

---

利用可能なツール

アカウント管理

ツール	説明
list_accounts	認証済みの Gmail アカウントをすべて一覧表示します
initiate_auth	OAuth フローを開始します — ブラウザーで開く URL を返します
complete_auth	Google サインインの完了後に認証を確定します
remove_account	アカウントと保存済みの認証情報を削除します

メールの読み取り

ツール	説明
search_emails	Gmail 構文を使って検索します（is:unread、from:、after: など）
get_email	メッセージ ID を指定してメールの全内容を取得します

メールの作成

ツール	説明
send_email	メールを送信します（To、CC、BCC に対応）
reply_to_email	References ヘッダーを保持してスレッドに返信します
create_draft	メールを下書きとして保存します

整理

ツール	説明
list_labels	アカウントの Gmail ラベルをすべて一覧表示します
add_label	メッセージに 1 つ以上のラベルを追加します
remove_label	メッセージから 1 つ以上のラベルを削除します
archive_email	受信トレイから削除します
mark_as_read	UNREAD ラベルを削除します
mark_as_unread	UNREAD ラベルを追加します

---

プロンプトの例

List all my authenticated Gmail accounts.

Search my [email protected] inbox for unread emails from this week.

Reply to that email from my personal account saying I'll be there Saturday.

Send an email from [email protected] to [email protected]
with subject "Dinner plans" and body "Are you free Saturday?"

Archive everything older than a week in my side-project inbox that's already read.

Check both my accounts for emails from GitHub and summarize them.

---

セキュリティ

• ~/.gmail-mcp-oauth.json と ~/.gmail-mcp-tokens.db はホームディレクトリに保存されます — プロジェクト外にあり、コミットされることはありません
• .gitignore で *.db、.gmail-mcp-oauth.json、.env を除外しています
• サーバーは stdio のみで動作します — ネットワークポートは開かれません
• OAuth スコープは必要最小限に制限されています

詳細は SECURITY.md をご覧ください。トークンの保存、ネットワーク動作、スコープの根拠、取り消し手順、脆弱性の報告方法について説明しています。

---

レジストリ

Anthropic 公式 MCP レジストリに掲載されています：

io.github.gx-55/multi-gmail-mcp

curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.gx-55"

---

プロジェクト構成

multi-gmail-mcp/
├── bin/
│   ├── gmail-mcp.js        # Entry point for the MCP server command
│   └── gmail-mcp-cli.js    # Entry point for the CLI command
├── src/
│   ├── server.js           # MCP server — all 19 tools
│   ├── gmail-client.js     # Gmail API wrapper
│   ├── auth.js             # OAuth2 flow with auto-refresh
│   ├── db.js               # SQLite token storage (node:sqlite)
│   └── cli.js              # Account management CLI
└── package.json

---

トラブルシューティング

「OAuth 認証情報が見つかりません」 ~/.gmail-mcp-oauth.json が存在することを確認するか、Claude Desktop の設定で GOOGLE_CLIENT_ID ／ GOOGLE_CLIENT_SECRET を設定してください。

「アカウントが見つかりません。先に認証してください」 Claude でそのアカウントを使用する前に、gmail-mcp-cli add [email protected] を実行してください。

Claude Desktop にツールが表示されない gmail-mcp が PATH に含まれていること（which gmail-mcp）を確認し、Claude Desktop を再起動してください。

トークンの有効期限切れエラー 有効なリフレッシュトークンが保存されていれば、トークンは自動更新されます。更新に失敗した場合は、アカウントを削除して再認証してください：gmail-mcp-cli remove [email protected] && gmail-mcp-cli add [email protected]。