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での準備
- Google Cloud Consoleでプロジェクトを作成
- Google Calendar APIを有効化
- OAuth 2.0クライアントIDを作成
- アプリケーションの種類: ウェブアプリケーション
- 承認済みのリダイレクトURI:
http://localhost:8080/callback
- 認証情報JSONファイルをダウンロード
2. 環境変数の設定
export CLIENT_SECRET_PATH="/path/to/client_secret.json"
export TOKEN_PATH="/path/to/token.json"3. インストールとビルド
pnpm install
pnpm build4. 初回認証
サーバーを起動すると、初回はブラウザで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
