Google Calendar MCP Server

Google Calendar MCP Server

この MCP サーバーを使用すると、Google Calendar のイベントにアクセスし、MCP インターフェースを通じて管理できます。Claude Desktop や、その他の MCP 対応クライアントで使用できます。

必要条件

• Python 3.10 以降 - MCP には Python 3.10 以降が必要です
• Calendar API が有効になっている Google Cloud プロジェクト
• 認証用の OAuth 認証情報

機能

• カレンダーイベントの表示：任意の日付または期間のイベントを表示します
• 新しいイベントの作成：タイトル、時刻、説明、場所、参加者を指定して作成します
• 既存イベントの更新：詳細を変更します
• 事前作成済みのプロンプト：一般的なカレンダー操作に使用できます

インストール

1. このリポジトリをクローンします：

   git clone <repository-url>
   cd google-calendar-mcp
   

2. Python 3.10 以降を使用して仮想環境を作成します：

   # Check your Python version
   python --version
   
   # Create a virtual environment with the correct Python version
   # For Python 3.10
   python3.10 -m venv venv
   # OR for Python 3.11
   python3.11 -m venv venv
   # OR for Python 3.12
   python3.12 -m venv venv
   
   # Activate the virtual environment
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   

3. pip を使用して依存関係をインストールします：

   pip install -r requirements.txt
   

   または、uv を使用すると、より速くインストールできます（推奨）：

   # Install uv if you don't have it
   curl -fsSL https://astral.sh/uv/install.sh | sh
   # On Windows: powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
   
   # Install dependencies with uv
   uv pip install -r requirements.txt
   

4. Google Calendar API の認証情報を設定します：

   a. Google Cloud Console にアクセスします b. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します c. Google Calendar API を有効にします d. OAuth 認証情報を作成します（デスクトップ クライアント OAuth ID） e. 認証情報の JSON ファイルをダウンロードし、プロジェクトディレクトリ内に credentials.json として保存します

使用方法

Claude Desktop での使用

1. 公式ウェブサイトから Claude Desktop をインストールします

2. Claude Desktop に MCP サーバーをインストールします：

   # Make sure you're in the project directory with the virtual environment activated
   mcp install calendar_mcp_server.py
   

3. Claude Desktop の設定ファイルを編集して、MCP サーバーを使用するように設定します：

   • Claude の設定ファイル /path/to/your/claude_desktop_config.json（Mac）または OS に応じた適切な場所を確認します
   • Google Calendar MCP を含めるように設定を追加または変更します：

   {
     "Google Calendar": {
       "command": "/path/to/your/venv/bin/mcp",
       "args": [
         "run",
         "/path/to/your/project/calendar_mcp_server.py"
       ]
     }
   }
   

   • /path/to/your/venv/ を実際の仮想環境のパスに置き換えます
   • /path/to/your/project/ を実際のプロジェクトディレクトリのパスに置き換えます

4. MCP サーバーが正常に実行されていることを確認します：

   • Claude Desktop を開きます
   • 左下にある設定アイコン（歯車）をクリックします
   • 設定メニューから「Developer」を選択します
   • 「Active MCP Servers」の下に「Google Calendar」が表示されていることを確認します
   • MCP サーバーが正しく実行されている場合は、緑色のステータスインジケーターが表示されます
   • 表示されない場合やエラーが表示される場合は、サーバーが実行中であることを確認します

5. これで、次のようなプロンプトを使用できます：

   Show me my events for today
   Create a meeting with John tomorrow at 2pm
   

Cursor での使用

1. Cursor を設定します：

   • Cursor を開きます。
   • Settings（通常は歯車アイコン、またはコマンドパレットから開きます）に移動します。
   • Cursor Settings > MCP に移動します。
   • Add New Global MCP Server をクリックします。
     • Google Calendar MCP を含めるように設定を追加または変更します：

     {
     "Google Calendar": {
        "command": "/path/to/your/venv/bin/mcp",
        "args": [
           "run",
           "/path/to/your/project/calendar_mcp_server.py"
        ]
     }
     }
     

     • /path/to/your/venv/ を実際の仮想環境のパスに置き換えます
     • /path/to/your/project/ を実際のプロジェクトディレクトリのパスに置き換えます

2. Cursor での使用：

   • Cursor で AI とチャットすると（たとえば、「エージェント」モードや MCP を利用する同様の機能を使用する場合）、実行中の Google Calendar MCP サーバーに接続できるようになります。
   • 次のようなカレンダー関連のプロンプトを使用できます：

     今日の予定を表示して
     明日の午後2時にJohnとの会議を作成して
     

   • 設定が正しく、サーバーが実行中であれば、Cursor はこれらのリクエストをローカルサーバーに送信します。

MCP Inspector を使用して開発モードで実行する：

MCP サーバーを開発またはデバッグする場合は、次のコマンドを使用します：

mcp dev calendar_mcp_server.py

これにより、追加のデバッグ情報と、リクエストやレスポンスを確認するためのウェブインターフェースが提供されます。

リソース

サーバーは次の MCP リソースを公開します。

• calendar://events/{date} - 指定した日付のイベントを返します。

使用例：

calendar://events/today
calendar://events/tomorrow
calendar://events/2023-07-15

ツール

サーバーは次のツールを提供します。

1. list_events(date_start, date_end=None) - 指定した期間のイベントを一覧表示します。
2. create_event(summary, start_datetime, end_datetime, ...) - 新しいカレンダーイベントを作成します。
3. update_event(event_id, ...) - 既存のイベントを更新します。

プロンプト

よく使う操作を簡単にする、事前に用意されたプロンプトです。

1. today_events - 今日のカレンダーにすばやくアクセスします。
2. schedule_meeting - 新しい会議を作成するためのガイド付きプロンプトです。

認証

初回使用時に、サーバーは Google OAuth 認証用のブラウザーウィンドウを開きます。アプリケーションを認証すると、今後の使用に備えて認証情報が token.json に保存されます。

トラブルシューティング

• Python のバージョンに関する問題：このプロジェクトには Python 3.10 以降が必要です。No matching distribution found for mcp[cli] のようなエラーが表示される場合は、Python のバージョンを確認してください。
• 認証エラー：credentials.json ファイルが正しい場所にあり、適切な権限が設定されていることを確認してください。
• MCP のインストールに関する問題：より確実にインストールするには、pip の代わりに uv をお試しください。

注意事項

• サーバーはタイムスタンプに UTC を使用します。イベントの時刻はローカルタイムゾーンで表示されます。
• このサーバーを使用するには、Google Cloud Console から取得した有効な credentials.json ファイルが必要です。
• 初回ログイン後、認証トークンは token.json に保存されます。