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

1. はじめに

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

Google Workspace MCP アーキテクチャ

演習内容

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

必要なもの

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

この Codelab を完了するまでに 30 分程度かかります。

この Codelab への簡単なアクセス

この Codelab にアクセスするための QR コード

2. 始める前に

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

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

API を有効にする

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

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

MCP サービスを有効にする

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

Chat アプリを構成する

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

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

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

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

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

Google Cloud コンソールで、[Google Auth Platform] > [ブランディング] に移動します。構成されていない場合は、[開始] をクリックします。
[**アプリ情報**] を構成します。
- アプリ名: Google Workspace MCP Servers
- ユーザーサポートメール: メールアドレスを選択します。
[対象ユーザー] を構成します。[内部] を選択します（[内部] が使用できない場合は [外部] を選択します）。
[**連絡先情報**] を構成します。メールアドレスを入力します。
ユーザーデータに関するポリシーを確認して同意し、[作成] をクリックします。
[外部] を選択した場合は、[対象ユーザー] に移動し、[テストユーザー] にメールアドレスを追加します。
[データアクセス] > [スコープの追加または削除] に移動します。[**スコープの手動追加**] で、使用するサーバーに次のものを追加します。
- 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
[テーブルに追加]、[更新]、[保存] の順にクリックします。

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

[Google Auth Platform] > [クライアント] > [クライアントの作成] に移動します。
アプリケーションの種類として [デスクトップアプリ] を選択します。
Gemini CLI という名前を付けます。
[作成] をクリックして、クライアント ID とクライアントシークレット をコピーします。これらは次のステップで必要になります。

4. Gemini CLI を構成する

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

構成ファイルを作成する

ホームディレクトリで ~/.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 データを操作できます。各サービスのプロンプトの例を次に示します。

Google カレンダー

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

「今週の今後の会議は何ですか？」
「明日の午後に空き時間はありますか？」

Google Chat

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

[「[SPACE_NAME]」で「[KEYWORD]」を含むメッセージを探して]

Google ドライブ

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

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

Gmail

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

「受信した最新の 5 件のメールを要約して」
["Draft an email to ‘[EMAIL_ADDRESS]' requesting an update on the ‘[PROJECT_NAME]' project."]

People API

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

「Google プロフィールによると、私の名前は何ですか？」
「'[NAME]' の連絡先情報を探して」

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

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

「ドライブで '[PROJECT_NAME] マイルストーンの更新' に関連するファイルを検索し、内容を要約して、'[NAME]' のメールアドレスを見つけて、要約を含む Gmail の下書きを作成して」

その他のツールを調べる

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

7. クリーンアップ

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

Google Cloud コンソールで、[API とサービスのダッシュボード] に移動します。
有効にした Google Workspace API と MCP API（カレンダー 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 データを操作する方法。

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

1. はじめに

演習内容

必要なもの

この Codelab への簡単なアクセス

2. 始める前に

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

API を有効にする

MCP サービスを有効にする

Chat アプリを構成する

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

OAuth 同意画面を設定する

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

4. Gemini CLI を構成する

構成ファイルを作成する

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

Gemini CLI を起動する

認証

カレンダー

チャット

ドライブ

Gmail

ユーザー

接続を確認する

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

Google カレンダー

Google Chat

Google ドライブ

Gmail

People API

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

その他のツールを調べる

7. クリーンアップ

8. 完了

学習した内容

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

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