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

CLI

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
calendar-json.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 \
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"
           ]
         }
       }
     }
   }
   

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

   • 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

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

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

   🟢 gmail - Ready (9 tools)
     Tools:
     - create_draft
     - 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
   

リモート 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 を追加**] をクリックし、 https://claude.ai/api/mcp/auth_callback を [**URI**] フィールドに追加します。

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

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

   1. Claude.ai または Claude Desktop で、[Settings]（または [Admin settings]）> [Connectors] に移動します。
   2. [Add custom connector] をクリックします。
   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
        • People API: https://people.googleapis.com/mcp/v1
   4. [Advanced settings] で、[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
  • People API: https://people.googleapis.com/mcp/v1

• トランスポート: HTTP

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