Google Workspace (multi-account)

mcp-google-multi

最も網羅的なローカル Google Workspace MCP サーバーです。Gmail、Drive、Calendar、Sheets、Docs、Slides、Forms、Contacts、Tasks、Chat、Meet、Analytics（GA4）、Search Console、Classroom、Vault、Admin などに対応し、OAuth でアクセス可能なすべての API メソッドをツールとして、複数の Google アカウントから同時に利用できます。Claude Code または任意の MCP クライアントでお使いいただけます。

• 🧰 網羅的 — 29 サービスにわたる 942 個のツールを提供。Google Analytics（GA4）にも対応し、さらにほかのあらゆる機能に対応するための手段も用意しています → COVERAGE.md
• 🔑 複数アカウント対応 — エイリアスで任意の数の Google アカウントを操作でき、1 回の呼び出しをすべてのアカウントに一斉に実行することもできます
• 🔒 プライバシーを重視した設計 — 独自の OAuth アプリを使用し、トークンは保存時に暗号化されます（AES-256-GCM）。書き込みはデフォルトで拒否され、テレメトリーも計測もありません。Google とのみ通信します
• 🌐 ローカルまたはリモート — stdio 経由でローカル実行するか、独自の OAuth 2.1 サーバーを内蔵した HTTP 経由のセルフホスト環境で実行できます（Claude Code の /mcp ログインと claude.ai コネクターに対応し、カスタム UI は不要です）。Docker Compose で取得して起動でき、自動 HTTPS にも対応しています → リモートのセットアップ
• ✉️ 実務向け — 添付ファイルや 1 回の呼び出しでの返信に対応した、Markdown 形式でのメール送受信、doctor セルフチェックを備えた対話型セットアップウィザード、アカウントごとのスコーププロファイルを提供します → 機能紹介

クイックセットアップ

初めての方にも使いやすいよう、Claude Code をインストールしたばかりで、API キーを作ったことがない方に向けて説明しています。各手順をコピーして貼り付けてください。表示される内容も説明しています。（技術に詳しい方は、簡潔にまとめた設定リファレンスをご覧ください。）

1. インストールします。 Node.js（緑色の「LTS」ボタン、バージョン 22 以降）を入手してから、次を実行します。

   npm install -g mcp-google-multi
   

   Claude Desktop をお使いの方は、npm を使わずに済みます。最新リリースから mcp-google-multi.mcpb バンドルをダウンロードしてダブルクリックするか、Claude Desktop → Settings → Extensions にドラッグし、プロンプトが表示されたら手順 2 の値を入力してください。

2. Google のキーを作成します（手作業が必要なのはここだけです。Google にはこの手順をスクリプト化する方法がないため、数分かかります）。手順に沿ったGoogle Cloud のセットアップを進めるか、Claude Code に次のように尋ねてください。「mcp-google-multi 用の Google OAuth Desktop クライアントの作成を案内してください。」 最後に、Client ID と Client Secret の 2 つの値が得られます。無料で利用でき、情報はご自身だけに保たれます。

3. ファイルに値を記入します。 実行するフォルダーに .env という名前のファイルを作成し、次を貼り付けて、ご自身の値を入力します。

   GOOGLE_CLIENT_ID=paste-your-client-id
   GOOGLE_CLIENT_SECRET=paste-your-client-secret
   # any short nickname, then your Gmail address:
   GOOGLE_ACCOUNTS=me:[email protected]
   

   暗号化キーを作成する必要はありません。サーバーが自動で生成し、保存します。

4. サインインします。 ブラウザーが開くので、アカウントを選んで「Allow」をクリックします。

   mcp-google-multi auth --account me
   

5. Claude Code に追加してから、Claude Code を再起動します。

   claude mcp add mcp-google-multi -s user -- npx -y mcp-google-multi
   

途中で困ったら、mcp-google-multi doctor を実行してください。 すべての項目を検査し、問題がある場合は具体的な修正方法を表示します（未サインイン、まだ有効にする必要がある Google API など）。すべてが緑色になったら、Claude に「未読メールを要約して」と話しかけてください。

Google アカウントを複数お持ちですか？ GOOGLE_ACCOUNTS=me:[email protected],work:[email protected] のようにまとめて追加し、手順 4 をニックネームごとに 1 回実行します。

サーバー上で使う場合や、claude.ai から使う場合は？ 上級者向けの手順：リモート／HTTP セットアップ。v5 から移行しますか？ v6 移行ガイド。

詳しく見る： 設定リファレンス · 対応範囲 · 機能紹介 · リモート／HTTP セットアップ · Vault でのシークレット管理 · ローカル使用状況メトリクス · v6 への移行 · セキュリティポリシー · ロードマップ

エージェントスキル

このリポジトリと npm パッケージには、skills/google-workspace/ に エージェントスキル が含まれています。アカウントの選択、検出ステップ、Gmail の差分取得、結果を小さく保つ方法、書き込みプロファイル、エスケープハッチについて説明した手書きの SKILL.md と、サービスごとに生成された引数テーブルを含む reference/ フォルダーで構成されています。これを読み込むと、エージェントは引数名を推測せずに、このサーバーのツールを正しく呼び出せます。

Claude Code にインストールするには、skills/google-workspace フォルダーを ~/.claude/skills/（すべてのプロジェクトに適用）またはプロジェクト独自の .claude/skills/（そのプロジェクトのみ）にコピーするか、シンボリックリンクを作成します。

# from a cloned copy of this repo
ln -s "$(pwd)/skills/google-workspace" ~/.claude/skills/google-workspace

# from the installed npm package
ln -s "$(npm root -g)/mcp-google-multi/skills/google-workspace" ~/.claude/skills/google-workspace

メンテナー、スポンサー、ライセンス

Abdelbaki Berkati が開発とメンテナンスを担当しています — berkati.xyz · @bakissation。導入事例を読む →

開発は IdeaCrafters（@IdeaCraftersHQ）の資金提供を受けています — この OSS の開発を支援するスタジオです。

エンタープライズエディション（ホステッド、マルチテナント）も利用できます。berkati.xyz からお問い合わせください（メールまたは LinkedIn）。

貢献者の @obatried、@trevor-commits、@mjreddy に感謝します。このプロジェクトはメンテナー主導で運営されています（ロードマップは Milestones をご覧ください。バグ報告は歓迎します。機能追加の PR は事前合意が必要です — CONTRIBUTING.md をご覧ください）。フィードバックがロードマップを形作ります。バグ、問題点、または追加してほしい機能について、issue を作成してください。 セキュリティに関する報告は SECURITY.md にお願いします。公開 issue には投稿しないでください。

MIT ライセンスのもとで公開されています。