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 - 利用可能なカラーパレットの取得

Related MCP server: mcp-google-calendar

セットアップ

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