gworkspace-mcp

Google Workspace（Google Sheets、Apps Script、Drive、Docs、Gmail、およびトリガー）の自動化のためのModel Context Protocolサーバーです。FastMCPを使用して構築されています。

Claude Code（またはMCP互換クライアント）から使用するように設計されており、会話から直接Apps Scriptプロジェクトの編集、スプレッドシートの操作、メールの送信、Driveファイルの管理が可能です。

機能

Apps Script (9ツール) — Apps Scriptプロジェクトのリスト表示、読み取り、更新、作成、デプロイ、実行。スクリプト全体を書き直す必要がない、きめ細かなファイル編集が可能です。
Sheets (10ツール) — 範囲の読み書き、バッチ更新、書式設定、保護、数式、ダッシュボード。
Drive (4ツール) — ファイルのリスト表示、検索、移動、管理。
Docs (1ツール) — Google Docsの読み取り/編集。
Gmail (3ツール) — メールの作成と送信。
Triggers (3ツール) — Apps Scriptの時間ベースおよびイベントベースのトリガー管理。
Connect (1ツール) — ローカルのApps Scriptプロジェクトをスプレッドシートにバインドします。

要件

Python 3.10以上
以下のAPIが有効化されたGoogle Cloudプロジェクト:
- Google Sheets API
- Google Drive API
- Apps Script API
- Google Docs API
- Gmail API
- Google Calendar API
OAuth 2.0 デスクトップ認証情報 (client_secret.json)

インストール

git clone https://github.com/LeooNic/gworkspace-mcp.git
cd gworkspace-mcp
pip install -e .

または uv を使用する場合:

uv pip install -e .

Google Cloudの設定

console.cloud.google.com にアクセスし、プロジェクトを作成します。
APIとサービス → ライブラリ で、上記にリストされたAPIを有効にします。
APIとサービス → OAuth同意画面 に移動し、外部として設定し、テストユーザーとして自分のGoogleアカウントを追加します。
APIとサービス → 認証情報 → 認証情報を作成 → OAuthクライアントID に移動し、デスクトップアプリを選択してJSONをダウンロードします。
以下のいずれかの方法で、サーバーが認証情報を使用できるようにします:
- JSONを ~/.secrets/gworkspace-mcp/client_secret.json に配置する、または
- GOOGLE_CLIENT_SECRET_PATH=/full/path/to/client_secret.json を設定する、または
- GOOGLE_OAUTH_CLIENT_ID および GOOGLE_OAUTH_CLIENT_SECRET を環境変数として設定する。

ツールを初めて実行する際、OAuth同意のためのブラウザウィンドウが開きます。生成されたトークンは ~/.secrets/gworkspace-mcp/token.json に保存され、自動的に更新されます。

Claude Codeへの登録

Claude Codeの settings.json (または ~/.claude.json) に以下を追加します:

{
  "mcpServers": {
    "gworkspace": {
      "command": "gworkspace-mcp"
    }
  }
}

gworkspace-mcp がPATH上にない場合は、pip install -e . によって作成された実行ファイルの絶対パスを使用してください（Windowsの場合、通常は C:\Users\<ユーザー名>\AppData\Local\Programs\Python\Python3XX\Scripts\gworkspace-mcp.exe です）。

エントリーポイントをインストールしない場合の代替呼び出し:

{
  "mcpServers": {
    "gworkspace": {
      "command": "python",
      "args": ["-m", "gworkspace_mcp.server"]
    }
  }
}

OAuthスコープ

サーバーは以下のスコープを要求します:

spreadsheets, drive, documents, calendar
script.projects, script.deployments, script.processes, script.metrics
gmail.send, gmail.compose
userinfo.email, userinfo.profile

セキュリティ上の注意

client_secret.json と token.json は個人情報です。絶対にコミットしないでください。リポジトリの .gitignore ですでに除外されています。
トークンは ~/.secrets/gworkspace-mcp/ に保存されます。
サーバーはローカルで実行され、ネットワークエンドポイントを公開することはありません。