Skip to main content
Glama
Sejin-Koo

google-workspace-mcp

by Sejin-Koo

google-workspace-mcp

Google Workspace(Sheets / Docs / Slides / Forms)とGoogle Driveを扱うMCPサーバー。

Coworkに標準接続されている公式「Google Drive」コネクタは検索・読み取り・ファイル作成・ゴミ箱移動のみを サポートし、既存ファイルの内容を変更することはできない。 そのため、シートに行を1つ追加するだけでも 全データを新しいファイルとして作り直し、既存ファイルを破棄する方法しかなかった。このサーバーはその 空白を埋める — ファイルIDを維持したままシートに行を追加し、ドキュメント本文を修正し、スライドを 追加する。

提供ツール

ツール

機能

sheets_values

セル値のread / append(行追加) / update / clear

sheets_manage

スプレッドシート作成、タブ追加・削除・名前変更、メタデータ取得、batchUpdate

docs_read

ドキュメントをテキスト(表含む)または元の構造で読み取り

docs_write

ドキュメント作成、末尾に追記、位置挿入、検索して置換、batchUpdate

slides_read

スライドごとのテキスト・発表者ノート取得

slides_write

プレゼンテーション作成、スライド追加(タイトル・本文入力)、削除、検索して置換

forms_tool

フォーム作成・取得、回答一覧・単件取得、batchUpdate

drive_search

ファイル名・内容全文検索・MIME・フォルダ条件検索

drive_file

メタデータ、作成、フォルダ作成、内容置換(ID維持)、名前変更、移動、コピー、ゴミ箱、完全削除、ダウンロード、export

drive_comments

コメント取得・作成・返信・解決・削除

drive_revisions

バージョン履歴取得、過去バージョンの内容回収、保持固定

drive_permissions

共有権限の確認・追加・変更・解除

drive_shared_drives

共有ドライブ一覧・詳細

drive_changes

開始トークン発行後、その以降の変更分のみ取得

すべてのツールはmax_charsで応答長の上限を調整でき、0の場合は切り詰めない。

Related MCP server: Google Docs, Drive & Sheets MCP Server

環境変数

名前

説明

GOOGLE_CLIENT_ID

OAuthクライアントID

GOOGLE_CLIENT_SECRET

OAuthクライアントシークレット

GOOGLE_REFRESH_TOKEN

https://www.googleapis.com/auth/driveスコープを含むrefresh token

MCP_GATE_KEYS

アクセスゲート許可キー一覧(カンマ区切り)。空の場合はゲート無効

MCP_GATE_MODE

enforceの場合はキーなしの呼び出しを401でブロック

driveスコープ1つでSheets・Docs・Slides・Forms APIとDrive API全体がカバーされる (各APIの公式認証スコープ一覧にauth/driveが含まれている)。

Google Cloudプロジェクトの準備

スコープとは別に、使用するAPIをプロジェクトで有効化(Enable) する必要がある。 有効にしないと403 has not been used in project ... or it is disabledが発生する。

  • Google Sheets API / Google Docs API / Google Slides API / Google Forms API

  • Google Drive API

呼び出し

https://<배포도메인>/api/mcp?k=<게이트키>

ローカルスモークテスト

scripts/.env.local.json(gitignore対象)に上記のGoogle認証情報3つを入れ、以下を実行:

npm install
npm test

実際のGoogleアカウントにテストファイルを作成し、最後にゴミ箱へ整理する。

Related MCP Connectors

Related MCP Servers