Google Calendar MCP Server

🚀 Google Calendar MCP Server

このドキュメントでは、Google Calendar APIを使用してカレンダー内容を検索し、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メニューのブランドページに移動するか、以下のリンクを訪問します。 ブランド

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

3. デスクトップアプリケーションの認証情報の設定 Google Cloud Consoleメニューのクライアントページに移動するか、以下のリンクを訪問します。 クライアント

   • 認証情報の作成をクリックします。
   • アプリケーションタイプでデスクトップアプリを選択します。
   • 名前フィールドに認証情報の名前を入力します。
   • 作成をクリックします。
   • 生成された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のプロキシモードを設定するには、以下の手順を実行します。

   • Visual Studio Codeを開き、拡張機能ビューに移動します。
   • “GitHub Copilot Chat”拡張機能を検索してインストールします。
   • インストールが完了したら、Visual Studio Codeを再起動します。

8. プロキシの起動

   • Visual Studio Codeで設定するフォルダを開きます。
   • 右側のアクティビティバーのプロキシアイコン（ロボットのアイコン）をクリックします。
   • 初めて使用する場合は、初期設定を求めるメッセージが表示されることがあります。指示に従って操作を完了します。
   • 以下のコマンドを入力してプロキシを起動します。

   npm run dev
   

   • プロキシは指定されたポートで実行され、デフォルトはlocalhost:3000です。

トラブルシューティング

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