google-workspace-mcp

マルチアカウント対応、トークン効率の高い Gmail + Calendar + Drive + Docs + Sheets 用 MCP。 公式の Claude コネクタが1アカウントしかサポートせず、デフォルトでメッセージやファイルの本文全体を返すため、これを補う目的で作られました。

なぜこれが必要か

• マルチアカウント: 複数のメールボックス（仕事 + 個人 + 共同創業者）を OAuth で認証できます。すべてのツールは account メールアドレスを受け取り、エイリアスは Send-As アイデンティティで処理されます。

• トークン効率: 検索・一覧はコンパクトな形式（メールは {id, from, subject, snippet, ...}、Drive は {id, name, mime, modified, size, ...}）を返します。本文やファイル内容はオプトインです。

• キーリングバックアップ: リフレッシュトークンは OS の資格情報ストア（macOS では Keychain、Windows では Credential Manager、Linux では Secret Service）に保存され、平文ファイルには保存されません。ボールトにもリポジトリにもトークンは置かれません。

• macOS・Windows・Linux: プラットフォームごとに1つのインストーラで、同じコネクタを使用します。

Related MCP server: google-workspace-mcp

ツール（v2、63ツール）

アカウント管理（3）

• gws_account_add — ブラウザ OAuth フローで、新しい認証済みメールボックスを追加

• gws_account_list — 認証済みアカウントとデフォルトを一覧表示

• gws_account_remove — ローカル資格情報を削除（Google 側の失効は行わない）

Gmail（12）

• gmail_search — Gmail の演算子で検索。コンパクトなレスポンス。

• gmail_read — 1件のメッセージまたはスレッド全体を読む。本文はオプトイン。

• gmail_send — メール送信、Send-As アイデンティティ用の from_alias オプション

• gmail_draft — 下書きを作成

• gmail_reply — 返信（スレッドとヘッダーを保持）、reply_all オプション

• gmail_labels_list — すべてのラベルを一覧表示

• gmail_label_apply — ラベルの一括追加・削除

• gmail_archive — 一括アーカイブ（INBOX から削除）

• gmail_trash — 一括でゴミ箱へ移動

• gmail_sendas_list — このメールボックスの Send-As アイデンティティを一覧表示

• gmail_attachments_list — メッセージの添付ファイルを一覧表示（ファイル名、MIME タイプ、サイズ）

• gmail_attachment_save — 添付ファイルを1件ローカルファイルにダウンロード、直接読み取り用のパスを返す

Calendar（7）

• cal_list_calendars — すべてのカレンダーを一覧表示

• cal_list_events — 今後のイベントを一覧表示（デフォルトはコンパクト、完全版は verbose=True）

• cal_create_event — イベントを作成、Google Meet リンクのオプション

• cal_update_event — フィールドを部分更新

• cal_delete_event — 削除

• cal_freebusy — スケジュール調整のためのビジー時間を確認

• cal_respond — 承諾・辞退・仮承諾

Drive（18）

• drive_search — フリーテキストまたは生の Drive q 構文。メタデータのみのレスポンス。

• drive_read_file — デフォルトはメタデータ、本文は include_content=True

• drive_list_folder — フォルダの直接の子を一覧表示（マイドライブは 'root'）

• drive_create_folder — オプションの親フォルダの下にフォルダを作成

• drive_upload — ローカルファイルをアップロード、オプションの convert_to_google

• drive_move — 親フォルダを変更

• drive_rename — ファイルまたはフォルダの名前を変更

• drive_share — メールアドレスで閲覧者・コメント投稿者・編集者などのアクセス権を付与

• drive_trash — ソフト削除（復元可能）

• drive_untrash — ゴミ箱から復元

• drive_permission_list — ファイルにアクセスできる全ユーザーを一覧表示

• drive_permission_update — 権限付与者のロールを変更

• drive_permission_delete — 権限を失効

• drive_shared_drives_list — このアカウントがアクセスできる共有ドライブを一覧表示

• drive_comments_list — 任意の Drive ファイル（ドキュメント・スプレッドシート・スライド・アップロード）のコメントを一覧表示

• drive_comment_add — コメントを追加、オプションのアンカー

• drive_comment_reply — コメントに返信

• drive_comment_resolve — コメントを解決済みにする

Docs（9）

• docs_create — 新しいドキュメントを作成、オプションの初期本文と親フォルダ

• docs_read — デフォルトはプレーンテキスト、完全な Docs API ツリーは structured=True

• docs_append — 本文の末尾にテキストを追加

• docs_insert_at — 指定インデックスにテキストを挿入

• docs_replace_text — 検索と置換、置換数を返す

• docs_export — markdown / pdf / docx / rtf / plain にエクスポート

• docs_suggestions_list — 保留中の変更提案（トラックチェンジ）を一覧表示

• docs_suggestions_accept_all — すべての提案を承諾（ドキュメントを書き換え）

• docs_suggestions_reject_all — すべての提案を却下（ドキュメントを書き換え）

Sheets（14）

• sheets_create — 新しいワークブックを作成、オプションの親フォルダ

• sheets_list_sheets — 行・列の寸法を含むタブを一覧表示

• sheets_add_sheet — 既存のワークブックに新しいタブを追加

• sheets_read_range — A1 範囲を読み取り。FORMULA / UNFORMATTED_VALUE オプション。

• sheets_write_range — 範囲を上書き。USER_ENTERED は数式を解析。

• sheets_append — 既存データの下に行を追加

• sheets_clear_range — 値をクリア（書式は保持）

• sheets_batch_read — 1回の API 呼び出しで複数範囲を読み取り

• sheets_batch_write — 1回の API 呼び出しで複数範囲を書き込み

• sheets_named_ranges_list — ワークブック内の名前付き範囲を一覧表示

• sheets_named_range_add — 名前付き範囲を作成

• sheets_named_range_delete — 名前付き範囲を削除

• sheets_conditional_format_add — 条件付き書式ルールを追加

• sheets_data_validation_add — ドロップダウン / 数値 / メール / URL の検証を設定

インストール

最速の方法 — 1つのスクリプトで、手動配線不要。

macOS と Linux:

git clone https://github.com/adelaidasofia/google-workspace-mcp.git
bash google-workspace-mcp/install.sh

Windows（PowerShell）:

git clone https://github.com/adelaidasofia/google-workspace-mcp.git
powershell -ExecutionPolicy Bypass -File .\google-workspace-mcp\install.ps1

インストーラは分離された venv を作成し、依存関係をインストールし、Google OAuth クライアント（対話式または環境変数 GWS_CLIENT_ID / GWS_CLIENT_SECRET 経由）を受け取り、サーバーを Claude Code に登録します。再実行しても安全です。ただし、最初に Google OAuth クライアントが必要です — 約45分の一度きりの GCP セットアップは SETUP.md を参照してください。その後、Claude Code から gws_account_add を実行して最初のメールボックスを認証します。

どちらも Python 3.10 以降が必要で、既存の Python を自動的に見つけます。

• macOS / Linux はまず python3 を試し、次に python3.14 から python3.10 までを試します。これにより、python3 が macOS の古いシステム版に解決される場合でも、Homebrew の Python が使われます。

• Windows はまず py -3（Python ランチャー）を試し、次に python、python3、バージョン付きの名前を試します。各候補は実行して自分のバージョンを報告する必要があるため、%LOCALAPPDATA%\Microsoft\WindowsApps にある Microsoft Store のプレースホルダーが選ばれることはありません。それは PATH 上にある実際の python.exe ですが、Store を開くだけのものです。

検索で見つからない場所（pyenv、conda、プライベートプレフィックス）に Python がある場合は、次のように指定します:

GWS_PYTHON=/full/path/to/python3 bash google-workspace-mcp/install.sh

$env:GWS_PYTHON = 'C:\full\path\to\python.exe'
powershell -ExecutionPolicy Bypass -File .\google-workspace-mcp\install.ps1

-ExecutionPolicy Bypass は意図的にコマンドに含まれています。 Windows はダウンロードしたスクリプトをデフォルトでブロックします。これは、マシンのポリシーを変更せずに、この1回の実行に例外を適用するものです。

Git Bash ではなく PowerShell から実行してください。 install.sh は Git Bash / MSYS を検出すると、そこで停止し、install.ps1 への案内を表示します。POSIX の venv パスを登録しても、ネイティブの Claude Code は起動できないためです。WSL は本物の Linux なので、引き続き install.sh を使用します。

タイムゾーン。 コネクタはマシンの IANA ゾーンを読み取るため、cal_* 呼び出しの「午後3時」はあなたの場所の午後3時を意味します。Windows はゾーンに独自の名前を付けます（SA Western Standard Time など）。そのため、インストーラが取り込む tzlocal を経由します。上書きするには GWS_TIME_ZONE=America/Bogota を設定します。

Claude Code を開いて、次を貼り付けます:

/plugin marketplace add adelaidasofia/google-workspace-mcp
/plugin install google-workspace-mcp@google-workspace-mcp

SETUP.md の一度きりの GCP セットアップ（v1 は約45分、v2 の Drive/Docs/Sheets は追加で約5分）を完了して、サーバーが OAuth に使う client_secret.json を用意する必要があります。Claude Code から gws_account_add を実行して最初のメールボックスを認証してください。

Windows では、その後 install.ps1 を実行してください。 プラグインの .mcp.json は python3 でサーバーを起動しますが、プラグインマニフェストには「Windows では代わりにこれを使う」と指定する方法がありません。Windows では python3 が存在しないか、Microsoft Store のプレースホルダーであるため、コネクタは登録されても起動しません。install.ps1 は絶対パスのインタープリタに対して再登録するため、すべてのプラットフォームで曖昧さがありません。

一度きりの GCP セットアップについては SETUP.md を参照してください（v1 は約45分、v2 で Drive/Docs/Sheets を有効にするには追加で約5分）。

セットアップ後:

pip3 install --break-system-packages -r requirements.txt

Claude Code に登録

プロジェクトの .mcp.json（またはグローバルアクセス用の ~/.claude.json）に追加します:

"google-workspace": {
  "type": "stdio",
  "command": "python3",
  "args": ["/path/to/google-workspace-mcp/server.py"]
}

Windows では、裸の名前ではなく実際のインタープリタへのフルパスを指定してください — そこでの python3 は通常 Microsoft Store のプレースホルダーで、解決はされますが Python は実行されません:

"google-workspace": {
  "type": "stdio",
  "command": "C:\\Users\\you\\google-workspace-mcp\\.venv\\Scripts\\python.exe",
  "args": ["C:\\Users\\you\\google-workspace-mcp\\server.py"]
}

v1 → v2 へのアップグレード

v2 では Drive + Docs + Sheets のスコープが追加されます。各認証済みアカウントは一度だけ再 OAuth する必要があります。Google が新しいスコープを付与するためです。SETUP.md のステップ 6b を参照してください。

ロードマップ

• v3: Gmail フィルタ、休暇応答、プッシュ通知（Gmail Watch）、Calendar ACL/委任、Slides、Forms、Tasks

• v4: サービス間のバッチリクエスト、Drive のリビジョン

関連 MCP

同じ作者、同じアーキテクチャパターン（FastMCP、書き込み時のドラフト+確認、ボールト自動エクスポート、MIT）:

• slack-mcp — マルチワークスペース Slack

• imessage-mcp — macOS iMessage

• whatsapp-mcp — whatsmeow 経由の WhatsApp

• apollo-mcp — Apollo.io CRM + シーケンス

• substack-mcp — Substack の執筆 + 分析

• luma-mcp — lu.ma イベント

• parse-mcp — markitdown / Docling / LlamaParse ルーター

• rescuetime-mcp — RescueTime 生産性データ

• graph-query-mcp — ボールトのナレッジグラフクエリ

• graph-autotagger-mcp — グラフからのウィキリンク提案

• investor-relations-mcp — シード調達パイプライントラッカー

• vault-sync-mcp — 双方向ボールト同期

テレメトリ

このプラグインは、特定のマシンで Claude Code セッションに初めて読み込まれたときに、myceliumai.co に単一の匿名インストールシグナルを送信します。

送信されるもの:

• プラグイン名（例: slack-mcp）

• プラグインバージョン（例: 0.1.0）

送信されないもの:

• ユーザー識別子、名前、メール、トークン、API キーは一切なし

• ファイルパス、メッセージ内容、作業に関するものは一切なし

• 重複排除処理後、IP アドレスは保存されません

理由: メンテナーがどのプラグインが実際にインストールされているかを把握し、使われているものに注意を向けるためです。

オプトアウト： Claude Code を起動する前に環境変数 MYCELIUM_NO_PING=1 を設定してください。フックはネットワーク呼び出しを完全にスキップします。すでにping済みのインストールは ~/.mycelium/onboarded-<plugin> にセンチネルを残します — 状態をリセットしたい場合は削除してください。

ライセンス

MIT

作成者：Mycelium AI。フルインストールまたはチーム版は diazroa.com をご覧ください。