google-workspace-mcp MCP — ユースケース, インストール & ライブデモ

なぜ使うのか

主な機能

5 aggregated tools covering Email, Calendar, Drive, Accounts, Queue
Multi-account — switch between work and personal in one session
queue_operations chains multi-step ops with result references
Ships as .mcpb bundle for Claude Desktop (mac/linux/windows)
OAuth 2.0 with user-provided client credentials

ライブデモ

実際の動作

google-workspace-2.replay ▶ 準備完了

0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "google-workspace-2": {
      "command": "npx",
      "args": [
        "-y",
        "google-workspace-mcp"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "google-workspace-2": {
      "command": "npx",
      "args": [
        "-y",
        "google-workspace-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "google-workspace-2": {
      "command": "npx",
      "args": [
        "-y",
        "google-workspace-mcp"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "google-workspace-2": {
      "command": "npx",
      "args": [
        "-y",
        "google-workspace-mcp"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "google-workspace-2",
      "command": "npx",
      "args": [
        "-y",
        "google-workspace-mcp"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json

{
  "context_servers": {
    "google-workspace-2": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "google-workspace-mcp"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add google-workspace-2 -- npx -y google-workspace-mcp

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方： google-workspace-mcp

Triage your inbox and draft replies

👤 Anyone buried in email ⏱ ~15 min intermediate

使うタイミング： Morning inbox. 200 unread. You want to know what needs a response today.

前提条件

Google Cloud OAuth client — console.cloud.google.com > Credentials

フロー

Authenticate

Authenticate my Gmail account via OAuth.✓ コピーしました

→ OAuth flow completes
Classify

Go through unread emails from last 24h. Bucket into: urgent reply, FYI, newsletter, spam-like. Count each bucket.✓ コピーしました

→ Counts + sample subjects per bucket
Draft replies

For the 'urgent reply' bucket, draft short replies (don't send). Show me drafts for approval.✓ コピーしました

→ Drafts ready for review

結果： 30 minutes of inbox triage in 5.

注意点

LLM hallucinates commitments in drafts — Never have it send directly — always draft + human review

Find a meeting slot across 5 attendees

👤 Anyone scheduling meetings ⏱ ~5 min beginner

使うタイミング： You need 45 minutes next week that works for 5 people across time zones.

フロー

Check availability

Find a 45-min slot next week that works for me + these 4 attendees [emails]. Exclude lunch hours in each TZ.✓ コピーしました

→ Candidate slots
Create event

Book the best slot as 'Weekly sync' with a Google Meet link; invite all.✓ コピーしました

→ Event created with video link

結果： Meeting scheduled without the Doodle dance.

注意点

Free/busy API only shows free/busy, not priorities — Ask each person before hard-booking optional slots

Audit a Drive folder's sharing permissions

👤 Ops / compliance ⏱ ~30 min intermediate

使うタイミング： Somebody shared a sensitive folder broadly. You want to know exactly who has access.

フロー

Enumerate

List all files under /Shared drives/Contracts/2025 with their sharing settings. Flag anything with 'anyone with link' or 'public'.✓ コピーしました

→ File list with exposure flags
Remediate

For each public file, change to 'restricted' and notify the owner. Show me the diff before executing.✓ コピーしました

→ Per-file change plan

結果： Drive posture improved in one pass.

注意点

Revoking may break active external workflows — Announce before revoking; use a grace period

組み合わせ

他のMCPと組み合わせて10倍の力を

google-workspace-2 + notion

Mirror Google Docs to Notion weekly

For each Doc created in /Shared/Team this week, export as Markdown and create Notion page in 'Team Docs'.✓ コピーしました

ツール

このMCPが提供する機能

ツール	入力	呼び出すタイミング	コスト
manage_email	action: 'search'\|'read'\|'send'\|'reply'\|'label'\|..., ...	Any Gmail op	1 Gmail API call
manage_calendar	action: 'list'\|'create'\|'update'\|'delete'\|'freebusy'\|..., ...	Any Calendar op	1 Calendar API call
manage_drive	action: 'search'\|'upload'\|'download'\|'share'\|'export'\|..., ...	Any Drive op	1 Drive API call
manage_accounts	action: 'add'\|'remove'\|'switch'\|'list'	Multi-account switching	free
queue_operations	steps[]	Chain ops that depend on each other (e.g. create doc, share it)	sum of steps

コストと制限

運用コスト

APIクォータ: Gmail: 1B units/day (most ops 5-50 units). Calendar/Drive: generous quotas.
呼び出しあたりのトークン: Drive list results can be big — paginate
金額: Free; Google Workspace license required for business accounts
ヒント: Cache account metadata. Gmail search is quota-heavy; scope with label/date filters.

セキュリティ

権限、シークレット、影響範囲

最小スコープ： Gmail.readonly + Calendar + Drive — grant only what you use

認証情報の保管： Tokens in OS keychain (XDG-compliant); OAuth refresh handled automatically

データ送信先： Your Google data flows through MCP to your LLM provider

絶対に付与しない： Gmail.modify to an unsupervised agent that can also read external URLs

OAuth refresh tokens are long-lived — if your machine is compromised, revoke at myaccount.google.com.
Gmail send is irrevocable — always stage as drafts for human review first.

トラブルシューティング

よくあるエラーと対処法

invalid_grant during OAuth

Client ID / redirect URI mismatch. Confirm the redirect URI registered in GCP matches what the MCP uses.

Quota exceeded

Backoff + batch. Gmail send has a daily cap; Drive has per-user/per-second limits.

確認： Google Cloud Console > APIs > Quotas

Tokens expired despite refresh

Refresh token revoked — re-auth. Common when account password changed or security event triggered.

代替案

google-workspace-mcp 他との比較

代替案	代わりに使う場面	トレードオフ
Official Google Workspace MCP (when/if shipped)	Google ships a first-party MCP	Would be more authoritative; for now this is the strongest community option
Zapier/Composio hosted Google Workspace tools	You want hosted + no OAuth setup	Middleware fees; less control

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る