Google Workspace MCP と Gemini CLI を使ってみる

1. はじめに

注: Gemini CLI をまだ使用していますか？Antigravity CLI を使用して Google Workspace MCP サーバーを設定する方法については、こちらの Codelab をご覧ください。移行について詳しくは、こちらの公式ブログ投稿をご覧ください。

この Codelab では、Model Context Protocol（MCP）を使用して Gemini CLI を Google Workspace データに接続する方法を学びます。MCP は、AI モデルがリモート サーバーから提供されるツールを安全に使用できるようにするオープン スタンダードです。クライアントとして Gemini CLI を使用し、コードを記述することなく Gmail、Google ドライブ、Google カレンダー、Google Chat、People API を操作します。

演習内容

• Google Cloud プロジェクトで Google Workspace MCP サービスを有効にします。
• これらの MCP サービスを使用するように Gemini CLI を構成します。
• Google Workspace のデータを操作する楽しくて便利なプロンプトを使用して、統合をテストします。

必要なもの

• ウェブブラウザ（Chrome など）
• Google Cloud プロジェクト
• Google Workspace アカウント
• ローカルマシンにインストールされた Gemini CLI

この Codelab の所要時間は 30 分程度です。

この Codelab に簡単にアクセス

2. 始める前に

Google Workspace デベロッパー プレビュー プログラム: Google Workspace MCP サーバーへのアクセスは、公開デベロッパー プレビュー プログラムの一部です。まだ登録していない場合は、https://developers.google.com/workspace/preview で登録し、アカウントがプログラムに承認されていることを確認してください。

Google Cloud プロジェクトを作成または選択する

Google Cloud コンソールで、Google Cloud プロジェクトを選択または作成します。

API を有効にする

Google Workspace MCP サーバーを使用するには、標準の Google Workspace API を有効にする必要があります。一部の MCP サーバーは独立して動作しますが、基盤となる標準 API を有効にする必要があるサーバーもあります。

• Gmail と Chat では、引き続き標準の API が必要です。
• ドライブでは、特定のツールに標準 API が必要です。
• カレンダーでは、標準 API を有効にする必要はありません。
• People API は、標準権限と MCP 機能の両方を処理するため、有効にする個別の MCP サービスはありません。

API を有効にする

MCP サービスを有効にする

次に、プロダクト専用の MCP サービスを有効にします。

MCP サービスを有効にする

Chat 用アプリを構成する

Google Chat MCP サーバーを使用するには、Google Cloud プロジェクトで Chat 用アプリを構成する必要があります。

1. Google Cloud コンソールで Google Chat API を検索し、[Google Chat API] > [管理] > [構成] をクリックします。Google Chat API に移動
2. Chat 用アプリを設定します。
   • [アプリ名] フィールドに「Chat MCP」と入力します。
   • [アバターの URL] フィールドに「https://developers.google.com/chat/images/quickstart-app-avatar.png」と入力します。
   • [説明] に「Chat MCP server」と入力します。
   • [機能] で、[インタラクティブ機能を有効にする] をオフにします。
   • [ログ] で、[エラーを Logging にロギングする] を選択します。
3. [保存] をクリックします。

3. OAuth 同意とクライアントを構成する

Google Workspace MCP サーバーは、安全な認証に OAuth 2.0 を使用します。OAuth 同意画面を構成し、デスクトップ アプリケーション クライアントを作成する必要があります。

OAuth 同意画面を設定する

Google Workspace MCP サーバーは、認証に OAuth 2.0 を使用します。まず同意画面を構成する必要があります。

1. Google Cloud コンソールで、[Google Auth Platform] > [ブランディング] に移動します。構成されていない場合は、[開始] をクリックします。
2. [アプリ情報] を設定します。
   • アプリ名: Google Workspace MCP Servers
   • ユーザー サポートメール: 自分のメールアドレスを選択します。
3. [対象] を構成します。[内部] を選択します（内部が使用できない場合は [外部] を選択します）。
4. [連絡先情報] を設定します。メールアドレスを入力します。
5. ユーザーデータに関するポリシーを確認して同意し、[作成] をクリックします。
6. [外部] を選択した場合は、[オーディエンス] に移動し、[テストユーザー] にメールアドレスを追加します。
7. [データアクセス] > [スコープを追加または削除] に移動します。[スコープの手動追加] で、使用するサーバーに応じて以下を追加します。
   • Google カレンダー: https://www.googleapis.com/auth/calendar.calendarlist.readonly、https://www.googleapis.com/auth/calendar.events.freebusy、https://www.googleapis.com/auth/calendar.events.readonly
   • Google Chat: 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
   • Google ドライブ: https://www.googleapis.com/auth/drive.readonly、https://www.googleapis.com/auth/drive.file
   • Gmail: https://www.googleapis.com/auth/gmail.readonly、https://www.googleapis.com/auth/gmail.compose
   • People API: https://www.googleapis.com/auth/directory.readonly、https://www.googleapis.com/auth/userinfo.profile、https://www.googleapis.com/auth/contacts.readonly
8. [Add to Table]、[Update]、[Save] の順にクリックします。

OAuth クライアント ID を作成する

Google Workspace MCP サーバー用に OAuth 2.0 クライアントを構成する場合は、[このクライアントを AI 搭載エージェントに使用する] を選択して、エージェント分類設定（is_agentic）を有効にする必要があります。この設定が有効になっていない OAuth クライアントは、Google Workspace MCP エンドポイントを呼び出すことができません。

1. [Google Auth Platform] > [クライアント] > [クライアントを作成]（または [API とサービス] > [認証情報] > [認証情報を作成] > [OAuth クライアント ID]）に移動します。
2. アプリケーションの種類として [デスクトップ アプリ] を選択します。
3. Gemini CLI という名前を付けます。
4. [このクライアントを AI 搭載エージェントに使用する] を選択して、OAuth クライアントで is_agentic 分類フラグを有効にします。
5. [Create] をクリックし、クライアント ID とクライアント シークレットをコピーします。これらの値は次のステップで必要になります。

4. Gemini CLI を構成する

次に、これらのエンドポイントを使用するように Gemini CLI を構成します。Gemini CLI がインストールされていない場合は、Gemini CLI のウェブサイトのインストール手順に沿ってインストールします。

ローカル環境が必要: この手順では Cloud Shell を使用しないでください。Gemini CLI では、OAuth 認証にローカル ブラウザが必要です。ローカルマシンのターミナルを使用してください。詳しくは、ブラウザ リダイレクトの要件をご覧ください。

構成ファイルを作成する

ホーム ディレクトリで ~/.gemini/settings.json を開くか作成し、次の構成を追加します。プレースホルダを OAuth 認証情報に置き換えます。

{
  "mcpServers": {
    "calendar": {
      "httpUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_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"
        ]
      }
    },
    "chat": {
      "httpUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_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"
        ]
      }
    },
    "drive": {
      "httpUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/drive.readonly",
          "https://www.googleapis.com/auth/drive.file"
        ]
      }
    },
    "gmail": {
      "httpUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/gmail.readonly",
          "https://www.googleapis.com/auth/gmail.compose"
        ]
      }
    },
    "people": {
      "httpUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/directory.readonly",
          "https://www.googleapis.com/auth/userinfo.profile",
          "https://www.googleapis.com/auth/contacts.readonly"
        ]
      }
    }
  }
}

5. MCP サーバーを認証して検証する

MCP サーバーを使用する前に、認証を行い、接続されていることを確認する必要があります。

Gemini CLI を起動する

ターミナルで次のコマンドを実行して Gemini CLI を起動します。

gemini

認証

Gemini CLI で対応するコマンドを実行して、テストするサービスを認証します。この Codelab で使用する予定のサービスでのみ認証する必要があります。

カレンダー

/mcp auth calendar

チャット

/mcp auth chat

ドライブ

/mcp auth drive

Gmail

/mcp auth gmail

ユーザー

/mcp auth people

ブラウザのプロンプトに沿って、各サービスを承認します。

接続を確認

ツールが読み込まれ、準備ができていることを確認します。

/mcp list

サービスが Ready であり、ツールが一覧表示されていることを示す出力が表示されます。

6. MCP サーバーをテストする

自然言語を使用して Google Workspace データを操作できるようになりました。各サービスのプロンプトの例を以下に示します。

注: 以下のプロンプトの角かっこで囲まれたプレースホルダ（[NAME]、[FILE_NAME] など）は、独自の Google Workspace データの実際の値に置き換えてください。

Google カレンダー

Gemini にスケジュールについて質問してみましょう。

• 「今週の予定されている会議を教えて」
• 「明日の午後に空き時間はありますか？」

Google Chat

Gemini に次のようにリクエストして、メッセージを検索してみましょう。

• 「[スペース名] で [キーワード] を含むメッセージを探して」

Google ドライブ

Gemini にファイルの検索や読み取りをリクエストしてみましょう。

• 「Google ドライブで [キーワード] を含むファイルを検索して」
• 「最近編集したドキュメントを一覧表示して。」
• 「[FILE_NAME] というドキュメントの内容を読み、主な目標を要約して。」

Gmail

Gemini にメールの検索や管理をリクエストしてみましょう。

• 「最近受信した 5 件のメールを要約して。」
• 「[EMAIL_ADDRESS] 宛てに、[PROJECT_NAME] プロジェクトの最新情報をリクエストするメールの下書きを作成して。」

People API

プロフィールや連絡先について Gemini に相談してみましょう。

• 「私の Google プロフィールに登録されている名前を教えて」
• 「[名前] の連絡先情報を探して」

複数のサービスを組み合わせる

MCP の真の力は、Gemini が複数のサービスにわたってタスクをオーケストレートするときに発揮されます。サービスをまたいだ機能を示す、次のプロンプトを試してみてください。

• 「[プロジェクト名] のマイルストーンの更新に関連するファイルをドライブで検索し、その内容を要約して、[名前] のメールアドレスを見つけ、その要約を記載した Gmail の下書きを作成して。」

その他のツールを見る

これらは、できることのほんの一例です。各サービスで利用可能なツールの完全なリストを確認して試すには、公式ドキュメントのサポートされているプロダクトのセクションをご覧ください。

7. クリーンアップ

プロジェクトを削除せずにクリーンアップするには、有効にした API と MCP サービスを無効にします。

1. Google Cloud コンソールで、[API とサービス] の [ダッシュボード] に移動します。
2. 有効にした Google Workspace API と MCP API（Calendar MCP、Chat MCP など）をそれぞれクリックし、[API を無効にする] をクリックします。

OAuth クライアント認証情報を使用する予定がない場合は、Google Auth Platform コンソールで削除します。

8. 完了

おめでとうございます！Gemini CLI を使用して、公式の Google Workspace MCP サーバーを構成し、テストしました。

学習した内容

• Google Cloud で Google Workspace MCP サービスを有効にする方法。
• MCP 用の OAuth クライアントを構成する方法。
• Gemini CLI を使用して、標準ツールで Google Workspace データを操作する方法。

リファレンス ドキュメント

• Model Context Protocol（MCP）の概要
• Google Workspace MCP サーバーを構成する
• OAuth の同意を構成する