google-suite-mcp

思考できるAIに、実行する手を与えましょう。

Claude Desktop、Cursor、Windsurf、Zed、VS Code (GitHub Copilot)、Gemini CLI、その他あらゆるModel Context Protocolクライアントに、Google Sheets、Docs、Drive、Apps Scriptの完全な読み書き制御を提供するオープンソースのGoogle Workspace MCPサーバーです。82種類のツールを1つのサーバーに集約。MITライセンス。

google-suite-mcpは、初のワークスペース・オペレーターです。Google WorkspaceをAIが操作可能なランタイムとして扱う唯一のMCPです。単なる読み取り専用のインターフェースとして公開するのではなく、1回の呼び出しでダッシュボードの構築、Apps Scriptのデプロイ、ドキュメントのフォーマットを行います。

10分間のOAuth設定が唯一の導入コストです。その後は、自然言語のプロンプト1つで、複数セルのKPIダッシュボードの構築（sheets_build_dashboard）、スキーマからの完全フォーマット済みシートの作成（sheets_build_sheet）、Google Apps ScriptのライブWebアプリとしての公開（script_deploy）が可能になります。これらは、私たちが知る限り他のGoogle MCPにはない、3つの複合プリミティブです。すべてのツールは実証済みです：30個中30個のエンドツーエンドテストが、モックではなく実際のGoogle APIに対して合格しています。 ここにリストされているツールはすべて、Googleのプロダクションエンドポイントに対して実行され、期待通りの結果を返しています。

MCPはプロトコルであり、Claudeの機能ではありません。Model Context Protocolに対応しているクライアントであれば、背後のモデルに関係なくこのサーバーを使用できます。

どこから始めればよいですか？ このリポジトリのURLをClaude Code、Claude Desktop、Cursor、またはChatGPTに貼り付けて、インストールを手伝うよう依頼してください。SETUP.mdは、AIが各ステップを案内し、Google Cloudのリンクを開き、最後にすべてが動作することを確認できるように書かれています。

60秒のプロンプトでできること

これらはロードマップ上の項目ではなく、実際の単一プロンプトの結果です。サーバーを接続したら、MCPクライアントに貼り付けてみてください。

• 「Q4シートに、収益、CAC、チャーン、MRRを含むKPIダッシュボードを作成して。フォーマット済みで、条件付き色分けもして。」 → sheets_build_dashboardを1回呼び出し。

• 「Clientsという新しいシートを作成して。これら12個の列、ヘッダーのスタイル、データの入力規則、最初の行の固定を含めて。」 → sheets_build_sheetを1回呼び出し。

• 「このブックのすべてのタブで『Q3 2025』のすべてのインスタンスを見つけて、『Q4 2025』に置き換えて。」 → sheets_find_replace_manyを1回呼び出し。

• 「このシートに紐付いたApps Scriptを作成して。毎週月曜の午前8時にサマリーをメールで送信するようにし、Webアプリとしてデプロイして。」 → script_deployを1回呼び出し。

• 「このGoogleドキュメントに、これらの行を含む5列の価格表を挿入して。」 → docs_insert_tableを1回呼び出し。

• 「Driveに共有フォルダを作成し、これら3つのファイルを移動して、リンクを知っている全員が閲覧できるように権限を設定して。」

• 「マージンが15%未満の行を赤くハイライトする条件付き書式を追加して。」

• 「H列の数式を保護して、シート上の他の誰も編集できないようにして。」

コード不要。手作業不要。AIクライアントからコンテキストを切り替える必要もありません。

なぜ別のGoogle Workspace MCPサーバーが必要なのか？

GitHub上のほとんどのGoogle MCPは、2つのカテゴリーのいずれかに分類されます。スプレッドシートをクエリできるが変更できない読み取り専用コネクタか、Docs、Drive、Apps Scriptを完全に無視したSheets専用の狭いアダプターです。これらはコネクタであり、REST APIの薄いラッパーに過ぎず、AIは何かを達成するために40回のツール呼び出しと大量のトークンを消費しなければなりません。

google-suite-mcpはコネクタではありません。オペレーターです。プリミティブはエンドポイント（範囲の読み取り、セルの書き込み、ファイルのリスト）ではなく、成果（このダッシュボードを構築する、このスクリプトをデプロイする、このレポートをフォーマットする）です。実際の作業はツールを横断するため、オペレーターはスイート全体をカバーします。実際の作業は単一のセル編集ではないため、オペレーターは複合プリミティブを提供します。

彼らがジグなら、私たちはザグを行きます。

機能比較

要件

• Node.js 20以降

• Googleアカウント（AIに操作させたいWorkspaceファイルへのアクセス権が必要）

• Google Cloudプロジェクト（無料枠で十分です）

• OAuth 2.0デスクトップ認証情報

• MCP互換クライアント: Claude Desktop、Cursor、Windsurf、Zed、VS Code (GitHub Copilot)、Gemini CLI、Cline、Goose、OpenAI Agents SDKで構築されたエージェント、またはMCPを話すその他のクライアント

Google Cloudを触ったことがない場合、初回設定には約10分を見込んでください。一度完了すれば、二度と行う必要はありません。

google-suite-mcpのインストール方法

npm install -g google-suite-mcp

または、グローバルインストールをスキップして、npx -y google-suite-mcp経由でMCPクライアントにオンデマンドで取得させることもできます（以下のクライアント設定ブロックを参照）。

いずれの場合も、サーバーは認証情報とOAuthトークンを~/.google-suite-mcp/に保存します。ツールを初めて実行すると、Google Cloud OAuthクライアントJSONをどこに配置すべきかが正確に指示され、同意のためのブラウザが開きます。一度限りのGoogle Cloudの手順については、SETUP.mdを参照してください。

Google Workspaceへの接続方法

これは設定の中で唯一、注意が必要な部分です。以下の各リンクは、次にクリックすべきGoogle Cloudコンソールのページを直接開くため、探す必要はありません。

完全なウォークスルー: SETUP.mdには、主要なエラーのトラブルシューティングを含め、すべての手順が順を追って記載されています。要約は以下の通りです：

1. Google Cloudプロジェクトを作成（10秒、無料枠）

2. 4つのAPIを有効にする（各リンクをクリックして「有効にする」を押す）：

   • Sheets API

   • Docs API

   • Drive API

   • Apps Script API

3. OAuth同意画面を設定：外部を選択し、テストユーザーとして自分のGoogleメールアドレスを追加します

4. OAuth 2.0デスクトップクライアントを作成：認証情報を作成 > OAuthクライアントID > デスクトップアプリ。クライアントIDとクライアントシークレットをコピーします。

5. .envに認証情報を貼り付け：

   cp .env.example .env

   次に.envを編集し、ステップ4のクライアントIDとクライアントシークレットを貼り付けます。

サーバーが初めてツールを実行するときにブラウザが開き、Googleの同意フローを案内し、リフレッシュトークンをローカルにキャッシュします。アクセスを取り消さない限り、再度認証する必要はありません。

手順で詰まった場合は、SETUP.mdをAIアシスタントに貼り付けて、1ステップずつ案内してもらうよう依頼してください。

MCPクライアントへの接続方法

すべてのMCP互換クライアントは、実行するcommandとargsのリストという同じ2つの要素を受け入れます。以下のブロックではnpxを使用しているため、ローカルのインストールパスを管理する必要はありません。

Claude Desktop

設定ファイルを開きます：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

このエントリを追加します：

{
  "mcpServers": {
    "google-suite": {
      "command": "npx",
      "args": ["-y", "google-suite-mcp"]
    }
  }
}

Claude Desktopを再起動します。ツールピッカーに82個のツールが表示されます。

Cursor, Windsurf, Zed, VS Code

各クライアントには独自のMCP設定場所がありますが、同じcommandとargsの形式を受け入れます。クライアントのMCPドキュメントを参照し、上記のブロックをMCPサーバーセクションの下に貼り付けてください。他の変更は不要です。

Gemini CLI

同じcommandとargsを使用して、Gemini CLIのMCP設定（~/.gemini/config.jsonまたは同等のもの）にサーバーを追加します。

OpenAI Agents SDK

OpenAI Agents SDK（PythonおよびTypeScript）はMCPサーバーをネイティブでサポートしています。エージェントを構築する際にMCPサーバーとしてgoogle-suite-mcpを渡すと、選択したOpenAIモデルで82個のツールが利用可能になります。

その他のMCPクライアント

Model Context Protocolを話すクライアントであれば動作します。クライアントがMCPサーバーを定義する場所で、同じcommandとargsパターンを使用してください。

使用例

サーバーが接続されると、これまで通りAIと会話するだけです。ただ、AIに手がついたというだけです。

スキーマからライブKPIダッシュボードを構築

「『Q4 Forecast』というタイトルのブックで、『Dashboard』という新しいタブを作成し、収益、粗利益、CAC、チャーンの4つのセルを持つKPIダッシュボードを構築して。『Raw』タブから値を抽出し、ヘッダーを太字にし、数値を通貨形式にし、目標を下回るものを赤くハイライトして。」

sheets_build_dashboardを1回呼び出し。完了。

スキーマをシートに変換

「『Client Tracker』という新しいシートを作成して。列は名前、メール、ステータス（ドロップダウン：リード / アクティブ / チャーン）、最終連絡日（日付）、メモ。チャーンの行が赤くなるように条件付き書式を追加して。」

sheets_build_sheetを1回呼び出し。完了。

実際の構造を持つドキュメントを作成

「DocsでHendersonプロジェクトのキックオフ概要をドラフトして。ステークホルダーテーブル、タイムラインテーブル、箇条書きのリスクセクションを含めて。」

docs_insert_tableは、ASCIIの模倣ではなく、実際のテーブルを提供します。

Apps Script Webアプリをデプロイ

「このシートに紐付いた新しいApps Scriptプロジェクトを作成して。SummaryタブをJSONとして返すdoGetを追加し、バージョン管理し、curlできるWebアプリとしてデプロイして。」

script_deployが公開します。ライブURLが取得できます。

ブック内のすべてのシートでフィールド名を変更

「Expensesブックで、すべてのシートにわたって『customer_id』のすべての出現箇所を『account_id』に一括で置き換えて。」

sheets_find_replace_manyが1回の呼び出しで処理します。

Driveを整理

「『2026 Client Intake』というフォルダを作成し、Drive内で名前に『intake』が含まれるすべてのファイルをその中に移動し、リンクを知っている全員が閲覧できるようにフォルダを共有して。」

ツールリストの概要（82ツール）

Googleのサーフェスごとにグループ化：

• Google Sheets (53ツール): 作成、リスト、読み取り、書き込み、追加、フォーマット、条件付き書式、チャート、名前付き範囲、保護範囲、フィルタ、ソート、入力規則、枠線、結合、ウィンドウ枠の固定、サイズ変更、検索/置換（単一およびすべてのタブを横断するsheets_find_replace_many）、検索、数式、配列数式、バッチ更新、複製、名前変更、並べ替え、削除、sheets_build_sheet、sheets_build_dashboard。

• Google Docs (8ツール): 作成、書き込み、テキストフォーマット、テキスト取得、テキスト置換、画像挿入、docs_insert_table、エクスポート。

• Google Drive (12ツール): アップロード、ダウンロード、検索、情報取得、移動、コピー、名前変更、ゴミ箱、フォルダ作成、共有、権限のリストと更新。

• Google Apps Script (7ツール): 作成、更新、取得、紐付け取得、実行、バージョン作成、script_deploy。

• Auth (2ツール): ステータス、リフレッシュ。

すべてのツールはトークン効率的なレスポンスを提供します。すべてのペイロードはエンドツーエンドで監査され、エージェントの長時間実行時にもコンテキストウィンドウが圧迫されないよう最適化されています。

ライブスキーマを含む公式リストについては、接続後にMCPクライアントからtools/listを呼び出すか、ソースツリーのsrc/tools/を参照してください。

FAQ

Cursor、Gemini CLI、またはその他の非Claude MCPクライアントで動作しますか？

はい。google-suite-mcpは標準のModel Context Protocolサーバーです。MCP互換クライアント（Claude Desktop、Cursor、Windsurf、Zed、GitHub Copilot搭載VS Code、Gemini CLI、Cline、Goose、またはOpenAI Agents SDKで構築されたエージェント）は、上記と同じcommandとargsパターンを使用して接続できます。貼り付け場所については、クライアントのMCP設定ドキュメントを参照してください。MCPはプロトコルであり、Claudeの機能ではありません。

GPT-4やGPT-5などのOpenAIモデルで使用できますか？

はい。OpenAI Agents SDKはMCPサーバーをネイティブでサポートしているため、OpenAIモデル上に構築するあらゆる