Google Calendar MCP Server

Google Calendar MCP サーバー

日本語のREADMEはこちら

このドキュメントでは、Google Calendar API を使用してカレンダーの内容を検索する MCP サーバーを利用するための環境設定手順を説明します。

前提条件

• uv がインストールされている必要があります。
• Google アカウント。

手順

1. Google Cloud プロジェクトを作成する

Google Cloud Console または以下のリンクから Google Calendar API を有効にします。

API を有効にする

2. OAuth 2.0 同意画面を設定する

Google Cloud Console のメニュー、または以下のリンクからブランディングページに移動します。

ブランディング

1. アプリケーション名を設定します。
2. ユーザーサポートのメールアドレスを設定します。
3. 開発者の連絡先情報を設定します。

3. デスクトップアプリケーションの認証情報を設定する

Google Cloud Console のメニュー、または以下のリンクからクライアントページに移動します。

クライアント

1. 認証情報を作成をクリックします。
2. アプリケーションの種類でデスクトップアプリをクリックします。
3. 名前欄に認証情報の名前を入力します。
4. 作成をクリックします。
5. ダウンロードした JSON ファイルを credentials.json として保存し、作業ディレクトリに移動します。

4. Python 環境を設定する

仮想環境を作成する

1. ターミナルまたはコマンドプロンプトを開きます。

2. プロジェクトディレクトリに移動します。

3. 仮想環境を設定し、必要なライブラリをダウンロードします。

   uv sync
   

token.json を生成する

1. 以下のコマンドを実行して token.json ファイルを生成します。

   uv run generate_token.py
   

2. Google アカウントへのアクセス許可を求めるブラウザーが開きます。許可を付与します。

3. 認証が完了すると、プロジェクトディレクトリに token.json ファイルが作成されます。

5. calendar_settings.json を設定する

1. プロジェクトディレクトリにある calendar_settings.json.sample ファイルを編集します。

たとえば、以下のように設定します。

{
  "calendar_ids": {
    "primary": "primary",
    "work": "example_work_schedule_id"
  }
}

• primary：Google アカウントのメインカレンダーの ID（通常は「primary」）。
• work：仕事用カレンダーの ID。

必要なカレンダー ID を設定し、ファイル名を calendar_settings.json に変更して保存します。

6. MCP を設定する

1. プロジェクトディレクトリ内の .vscode ディレクトリに移動し、mcp.json.sample ファイルを編集します。

2. mcp.json.sample ファイルを以下のように編集します。

   {
     "servers": {
       "google-calendar-mcp-server": {
         "type": "stdio",
         "command": "/home/<username>/<dir>/.venv/bin/python",
         "args": [
           "/home/<username>/<dir>/google_calendar_mcp_server.py"
         ]
       }
     }
   }
   

   • <username> を自分のユーザー名に置き換えます。
   • <dir> をプロジェクトディレクトリ名に置き換えます。

   たとえば、ユーザー名が tatsuya で、プロジェクトディレクトリ名が google-calendar-mcp-server の場合、設定は以下のようになります。

   {
     "servers": {
       "google-calendar-mcp-server": {
         "type": "stdio",
         "command": "/home/tatsuya/google-calendar-mcp-server/.venv/bin/python",
         "args": [
           "/home/tatsuya/google-calendar-mcp-server/google_calendar_mcp_server.py"
         ]
       }
     }
   }
   

3. 編集後、ファイル名を mcp.json に変更して保存します。

7. エージェントモードを設定する

以下の手順に従って、Visual Studio Code の GitHub Copilot Chat でエージェントモードを設定します。

1. Visual Studio Code を開き、拡張機能ビューに移動します。
2. 「GitHub Copilot Chat」拡張機能を検索してインストールします。
3. インストールすると、サイドバーに「Copilot Chat」アイコンが表示されます。クリックして Copilot Chat パネルを開きます。
4. Copilot Chat パネル上部の歯車アイコンをクリックして設定を開きます。
5. 設定で「エージェントモード」を有効にします。

8. MCP を使用する

1. Copilot Chat パネルを開きます。
2. たとえば、「4月8日の予定を一覧表示してください」のような内容を入力してチャットします。
3. ツールの実行確認が表示されるので、続行ボタンをクリックして実行します。
4. 初回使用時は、Google アカウントへのアクセス許可を求めるブラウザーが開きます。許可を付与します。
5. 結果が表示されます。

トラブルシューティング

• エラーが発生した場合：エラーメッセージを確認し、必要に応じて依存関係を再インストールするか、Google Cloud Console の設定を確認してください。