Google Calendar MCP Server

Google Calendar MCP サーバー

Google Calendar のデータにアクセスできる Model Context Protocol（MCP）サーバーです。

機能

• 利用可能な Google Calendar の一覧表示
• カレンダーの空き時間枠の検索
• カレンダーの今後の予定の取得

前提条件

• Python 3.9+
• Calendar API が有効になっている Google Cloud プロジェクト
• OAuth2 認証情報

セットアップ

1. 依存関係をインストールします。

   pip install -r requirements.txt
   

2. Google Calendar API の認証情報を設定します。

   python setup_credentials.py
   

   プロンプトに従って Google で認証します。

3. サーバーを実行します。

   python google_calendar_server.py
   

Claude Desktop での使用

設定ファイルを編集して、このサーバーを使用するよう Claude Desktop を設定します。

{
  "mcpServers": {
    "google-calendar": {
      "command": "python",
      "args": ["/full/path/to/google_calendar_server.py"],
      "env": {
        "GOOGLE_TOKEN_FILE": "/path/to/token/file.json"
      }
    }
  }
}

利用可能なツール

list_calendars

利用可能なすべての Google Calendar を一覧表示します。

get_available_slots

カレンダーの空き時間枠を検索します。

パラメーター：

• calendar_id：確認するカレンダーの ID
• days_ahead：確認する日数（デフォルト：7）
• slot_duration_minutes：各時間枠の長さ（分）（デフォルト：30）
• start_hour：開始時刻（24 時間形式）（デフォルト：9）
• end_hour：終了時刻（24 時間形式）（デフォルト：17）

get_upcoming_events

カレンダーの今後の予定を取得します。

パラメーター：

• calendar_id：確認するカレンダーの ID
• days_ahead：確認する日数（デフォルト：7）
• max_events：返す予定の最大数（デフォルト：10）