Google Workspace MCP サーバーを構成する

CLI

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
people.googleapis.com --project=PROJECT_ID

PROJECT_ID は、実際の Google Cloud プロジェクト ID に置き換えます。

Console

Google Cloud コンソールで API を有効にします。

API を有効にする

CLI

gcloud services enable gmailmcp.googleapis.com \
drivemcp.googleapis.com \
calendarmcp.googleapis.com \
chatmcp.googleapis.com \
people.googleapis.com --project=PROJECT_ID

PROJECT_ID は、実際の Google Cloud プロジェクト ID に置き換えます。

Console

Google Cloud コンソールで MCP サービスを有効にします。

MCP サービスを有効にする

Gemini CLI

Google Workspace リモート MCP サーバーを Gemini CLI に追加するには、サーバー構成を settings.json ファイルに追加します。

1. OAuth 2.0 クライアント ID とシークレットを作成します。

   1. Google Cloud コンソールで、[Google Auth Platform] > [クライアント] > [クライアントの作成] に移動します。

      [クライアントの作成] に移動

   2. アプリケーションの種類として [デスクトップ アプリ] を選択します。

   3. 名前を入力します。

   4. [作成] をクリックして、クライアント ID とクライアント シークレットをコピーします。

2. 構成ファイル ~/.gemini/settings.json を開くか、作成します。

3. mcpServers 構成を settings.json に追加します。

   {
     "mcpServers": {
       "gmail": {
         "httpUrl": "https://gmailmcp.googleapis.com/mcp/v1",
         "oauth": {
           "enabled": true,
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET",
           "scopes": [
             "https://www.googleapis.com/auth/gmail.readonly",
             "https://www.googleapis.com/auth/gmail.compose"
           ]
         }
       },
       "drive": {
         "httpUrl": "https://drivemcp.googleapis.com/mcp/v1",
         "oauth": {
           "enabled": true,
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET",
           "scopes": [
             "https://www.googleapis.com/auth/drive.readonly",
             "https://www.googleapis.com/auth/drive.file"
           ]
         }
       },
       "calendar": {
         "httpUrl": "https://calendarmcp.googleapis.com/mcp/v1",
         "oauth": {
           "enabled": true,
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET",
           "scopes": [
             "https://www.googleapis.com/auth/calendar.calendarlist.readonly",
             "https://www.googleapis.com/auth/calendar.events.freebusy",
             "https://www.googleapis.com/auth/calendar.events.readonly"
           ]
         }
       },
       "people": {
         "httpUrl": "https://people.googleapis.com/mcp/v1",
         "oauth": {
           "enabled": true,
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET",
           "scopes": [
             "https://www.googleapis.com/auth/directory.readonly",
             "https://www.googleapis.com/auth/userinfo.profile",
             "https://www.googleapis.com/auth/contacts.readonly"
           ]
         }
       },
       "chat": {
         "httpUrl": "https://chatmcp.googleapis.com/mcp/v1",
         "oauth": {
           "enabled": true,
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET",
           "scopes": [
             "https://www.googleapis.com/auth/chat.spaces.readonly",
             "https://www.googleapis.com/auth/chat.memberships.readonly",
             "https://www.googleapis.com/auth/chat.messages.readonly",
             "https://www.googleapis.com/auth/chat.users.readstate.readonly"
           ]
         }
       }
     }
   }
   

   次のように置き換えます。

   • OAUTH_CLIENT_ID: 作成したクライアント ID。
   • OAUTH_CLIENT_SECRET: 作成したクライアント シークレット。

4. settings.json 割引されます。

5. Gemini CLI を起動します。

   gemini
   

6. Gemini CLI で、次のコマンドを実行して各 MCP サーバーで認証します。

   /mcp auth gmail
   

   1. プロンプトが表示されたら、1 を押してブラウザで認証ページを開きます。SSH 経由で作業している場合は、CLI の手順に沿って操作します。
   2. Google アカウントにログインします。
   3. リクエストされた OAuth スコープを確認し、[許可] をクリックします。
   4. 認証が成功したことを確認するメッセージが表示されます。

   5. 各 MCP サーバーに対して次の手順を繰り返します。

      • /mcp auth drive
      • /mcp auth calendar
      • /mcp auth people
      • /mcp auth chat

7. Gemini CLI で /mcp list を実行して、構成済みの MCP サーバーとそのツールを表示します。

   レスポンスは次の例のようになります。

   🟢 gmail - Ready (10 tools)
     Tools:
     - create_draft
     - create_label
     - get_thread
     - label_message
     - label_thread
     - list_drafts
     - list_labels
     - search_threads
     - unlabel_message
     - unlabel_thread
   
   🟢 drive - Ready (7 tools)
     Tools:
     - create_file
     - download_file_content
     - get_file_metadata
     - get_file_permissions
     - list_recent_files
     - read_file_content
     - search_files
   
   🟢 calendar - Ready (8 tools)
     Tools:
     - create_event
     - delete_event
     - get_event
     - list_calendars
     - list_events
     - respond_to_event
     - suggest_time
     - update_event
   
   🟢 people - Ready (3 tools)
     Tools:
     - get_user_profile
     - search_contacts
     - search_directory_people
   
   🟢 chat - Ready (2 tools)
     Tools:
     - search_conversations
     - list_messages
   

リモート MCP サーバーを Gemini CLI で使用する準備が整いました。

Claude

Claude.ai または Claude Desktop で Google Workspace リモート MCP サーバーを使用するには、Claude Enterprise、Pro、Max、または Team プランが必要です。

Google Workspace リモート MCP サーバーを Claude に追加するには、OAuth クライアント ID とシークレットを使用してカスタム コネクタを構成します。

1. OAuth 2.0 クライアント ID とシークレットを作成します。

   1. Google Cloud コンソールで、[Google Auth Platform] > [クライアント] > [クライアントの作成] に移動します。

      [クライアントの作成] に移動

   2. アプリケーションの種類として [ウェブ アプリケーション] を選択します。

   3. 名前を入力します。

   4. [承認済みのリダイレクト URI] セクションで、[+ URI を追加] をクリックし、[URI] フィールドに https://claude.ai/api/mcp/auth_callback を追加します。

   5. [作成] をクリックして、クライアント ID とクライアント シークレットをコピーします。

2. Claude で MCP サーバーを構成します。

   1. Claude.ai または Claude Desktop で、[設定]（または [管理者設定]）> [コネクタ] に移動します。
   2. [カスタム コネクタを追加] をクリックします。
   3. 追加する Google Workspace サービスの接続の詳細を入力します。
      • サーバー名: サーバーの名前（Gmail など）。
      • リモート MCP サーバーの URL: Google Workspace サービスの URL（次のいずれかなど）。
        • Gmail: https://gmailmcp.googleapis.com/mcp/v1
        • Google ドライブ: https://drivemcp.googleapis.com/mcp/v1
        • Google カレンダー: https://calendarmcp.googleapis.com/mcp/v1
        • Google Chat: https://chatmcp.googleapis.com/mcp/v1
        • People API: https://people.googleapis.com/mcp/v1
   4. [詳細設定] で、OAuth クライアント ID と OAuth クライアント シークレットを入力します。
   5. [追加] をクリックします。
   6. 追加する Google Workspace サービスごとに、この手順を繰り返します。

その他

多くの AI アプリケーションには、リモート MCP サーバーに接続する方法があります。通常は、サーバー名、エンドポイント、トランスポート プロトコル、認証方法などのサーバーの詳細情報を入力する必要があります。Google Workspace リモート MCP サーバーの場合は、次のように入力します。

• サーバー名: googleworkspace

• サーバー: 各 Google Workspace サービスには独自のサーバー URL があります。

  • Gmail: https://gmailmcp.googleapis.com/mcp/v1
  • Google ドライブ: https://drivemcp.googleapis.com/mcp/v1
  • Google カレンダー: https://calendarmcp.googleapis.com/mcp/v1
  • Google Chat: https://chatmcp.googleapis.com/mcp/v1
  • People API: https://people.googleapis.com/mcp/v1

• トランスポート: HTTP

• 認証: Google Workspace リモート MCP サーバーは OAuth 2.0 を使用します。詳細については、認証と認可についてをご覧ください。