Google Calendar MCP Server

Google Calendar APIを操作するMCP (Model Context Protocol) サーバーです。

機能

カレンダー操作

• list_calendars - カレンダー一覧の取得
• get_calendar - カレンダー詳細の取得

イベント操作

• list_events - イベント一覧の取得
• get_event - イベント詳細の取得
• search_events - イベントの検索
• create_event - イベントの作成（定期イベント対応）
• update_event - イベントの更新
• delete_event - イベントの削除

定期イベント操作

• update_recurring_event - 定期イベントの更新
  • thisEventOnly: この予定のみ
  • all: すべての予定
  • thisAndFollowing: これ以降の予定
• delete_recurring_instance - 定期イベントの特定インスタンス削除

ユーティリティ

• get_freebusy - 空き時間情報の取得
• list_colors - 利用可能なカラーパレットの取得

セットアップ

1. Google Cloud Consoleでの準備

1. Google Cloud Consoleでプロジェクトを作成
2. Google Calendar APIを有効化
3. OAuth 2.0クライアントIDを作成
   • アプリケーションの種類: ウェブアプリケーション
   • 承認済みのリダイレクトURI: http://localhost:8080/callback
4. 認証情報JSONファイルをダウンロード

2. 環境変数の設定

export CLIENT_SECRET_PATH="/path/to/client_secret.json"
export TOKEN_PATH="/path/to/token.json"

3. インストールとビルド

pnpm install
pnpm build

4. 初回認証

サーバーを起動すると、初回はブラウザでGoogle認証を求められます。認証後、トークンが保存され、以降は自動的に認証されます。

使用方法

Claude Desktopでの設定

claude_desktop_config.jsonに以下を追加:

{
  "mcpServers": {
    "google-calendar": {
      "command": "node",
      "args": ["/path/to/google-calendar-mcp/dist/index.js"],
      "env": {
        "CLIENT_SECRET_PATH": "/path/to/client_secret.json",
        "TOKEN_PATH": "/path/to/token.json"
      }
    }
  }
}

Claude Codeでの設定

claude mcp add google-calendar node /path/to/google-calendar-mcp/dist/index.js \
  -e CLIENT_SECRET_PATH=/path/to/client_secret.json \
  -e TOKEN_PATH=/path/to/token.json

使用例

イベント一覧の取得

今日の予定を教えて

イベントの作成

明日の14時から15時に「打ち合わせ」という予定を作成して

定期イベントの作成

毎週月曜日の10時から11時に「週次ミーティング」を10回作成して

定期イベントの個別編集

今週の週次ミーティングだけ時間を11時からに変更して

技術スタック

• TypeScript
• Node.js >= 18.0.0
• @modelcontextprotocol/sdk
• googleapis
• zod

ライセンス

MIT