Google Workspace (gsuite-sdk)

gsuite-mcp

Google Workspace（Gmail、Calendar、Drive、Sheets、Tasks、Contacts）用のMCPサーバーです。gsuite-sdkを基盤として構築されています。ローカルで stdio 経由で動作し、ご自身の Google アカウントを使用します。

セットアップ

1. Google Cloud から OAuth クライアントファイルを取得し （ガイド）、 gsuite CLI で一度ログインします：

   pip install "gsuite-sdk[cli]"
   gsuite auth login                                   # Gmail, Calendar, Drive, Sheets
   gsuite auth login --force --scopes default,tasks,contacts   # + Tasks and Contacts
   gsuite auth login --force --scopes default,tasks,contacts,marketing  # + Search Console, GA4, Tag Manager (read-only)
   

   トークンは、カレントディレクトリ内の tokens.db（または GSUITE_TOKEN_DB_PATH）に保存されます。

2. 絶対パスを指定して、そのトークンを参照するように MCP クライアントに サーバーを追加します：

   {
     "mcpServers": {
       "gsuite": {
         "command": "uvx",
         "args": ["gsuite-mcp"],
         "env": {
           "GSUITE_TOKEN_DB_PATH": "/Users/you/gsuite/tokens.db",
           "GSUITE_CREDENTIALS_FILE": "/Users/you/gsuite/credentials.json",
           "GSUITE_DEFAULT_TIMEZONE": "America/Argentina/Buenos_Aires"
         }
       }
     }
   }
   

   Claude Code：claude mcp add gsuite -e GSUITE_TOKEN_DB_PATH=/Users/you/gsuite/tokens.db -- uvx gsuite-mcp

ツール

分野	ツール
アカウント	auth_status
Gmail	gmail_search、gmail_read、gmail_send、gmail_reply、gmail_create_draft
Calendar	calendar_list_events、calendar_create_event、calendar_delete_event、calendar_free_busy
Drive	drive_search、drive_read_file、drive_upload、drive_share
Sheets	sheets_read、sheets_append、sheets_update、sheets_upsert
Tasks	tasks_list、tasks_add、tasks_complete
Contacts	contacts_search、contacts_get
Search Console（読み取り専用）	searchconsole_list_sites、searchconsole_query、searchconsole_inspect_url、searchconsole_list_sitemaps
Analytics GA4（読み取り専用）	analytics_account_summaries、analytics_list_properties、analytics_run_report、analytics_run_realtime_report
Tag Manager（読み取り専用）	tagmanager_list_accounts、tagmanager_list_containers、tagmanager_list_workspaces、tagmanager_list_tags、tagmanager_list_triggers、tagmanager_list_variables、tagmanager_list_versions

Search Console、Analytics、Tag Manager を使用するには、オプトインの読み取り専用スコープ （--scopes ...,marketing）を指定し、Cloud プロジェクトで各 API を有効にする必要があります。ログインすると保存済みのスコープが置き換えられるため、すでに使用しているスコープのセットも引き続き列挙してください。

読み取りツールには読み取り専用の注釈が付いています。送信、共有、上書き、削除を行うツールには、実行前にクライアントが確認できるよう印が付いています。日付は ISO 8601 形式です。オフセットのない時刻には GSUITE_DEFAULT_TIMEZONE が使用されます（デフォルトは UTC）。

同じ機能はエージェントスキル、CLI、REST API としても利用できます。詳しくはgsuite-sdkをご覧ください。

ライセンス

MIT