Google Calendar MCP Server
Google CalendarのイベントをAIから作成・検索・更新できるコミュニティ版MCPサーバー。スケジュール調整や会議設定をAIとの自然な対話で実行できる。
Google Calendarスケジュール管理カレンダー会議調整タスク管理
- 最終確認:
- 2026-03-29
- ライセンス:
- MIT
設定方法
{
"mcpServers": {
"google-calendar": {
"command": "npx",
"args": ["-y", "@cocal/google-calendar-mcp"],
"env": {
"GOOGLE_CLIENT_ID": "<YOUR_GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<YOUR_GOOGLE_CLIENT_SECRET>",
"GOOGLE_REDIRECT_URI": "http://localhost:3000/oauth2callback"
}
}
}
}
{
"mcpServers": {
"google-calendar": {
"command": "npx",
"args": ["-y", "@cocal/google-calendar-mcp"],
"env": {
"GOOGLE_CLIENT_ID": "<YOUR_GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<YOUR_GOOGLE_CLIENT_SECRET>",
"GOOGLE_REDIRECT_URI": "http://localhost:3000/oauth2callback"
}
}
}
}
{
"mcpServers": {
"google-calendar": {
"command": "npx",
"args": ["-y", "@cocal/google-calendar-mcp"],
"env": {
"GOOGLE_CLIENT_ID": "<YOUR_GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<YOUR_GOOGLE_CLIENT_SECRET>",
"GOOGLE_REDIRECT_URI": "http://localhost:3000/oauth2callback"
}
}
}
}
概要
Google Calendar MCP Serverは、コミュニティが開発したMCPサーバーです。Claude DesktopやCursorなどのAIクライアントから、Google CalendarのイベントをAIが直接作成・検索・更新できます。
「来週火曜日の午後に1時間のミーティングを追加して」「今週の予定を確認して空き時間を教えて」といった自然言語の指示を、AIがCalendar APIを通じて実行します。手動でカレンダーアプリを開かなくても、AIとの対話だけでスケジュール管理が完結します。
導入手順
前提条件
- Node.js 18以上
- Googleアカウント
- Google Cloud ConsoleでのOAuthクライアントの作成
ステップ
- Google Cloud Console で新しいプロジェクトを作成(または既存を使用)
- "APIとサービス" → "ライブラリ" で Google Calendar API を有効化
- "APIとサービス" → "認証情報" で OAuth 2.0 クライアントID を作成
- アプリケーションの種類: デスクトップアプリ
- 承認済みのリダイレクトURIに
http://localhost:3000/oauth2callbackを追加
- Client IDとClient Secretをメモ
- ページ上部のタブから使用環境(Claude Desktop / Cursor / Cline)を選択し、JSON設定をコピー
<YOUR_GOOGLE_CLIENT_ID>と<YOUR_GOOGLE_CLIENT_SECRET>を置き換え- コピーしたJSONを設定ファイル(claude_desktop_config.json など)に追記して保存
- クライアントを再起動
- 初回起動時にブラウザでGoogle認証が求められます。指示に従って承認してください
使い方の例
「今週の予定を一覧表示して」
「明日の14時から15時で『プロダクトレビュー』というミーティングを作成して、参加者にteam@example.comを追加して」
「来週の空き時間(平日9時〜18時)を30分単位で教えて」
「3月のイベントで『〇〇さんとの面談』というタイトルのものを検索して」
注意事項
- Client IDとClient Secretはソースコードやチャット履歴に含めないよう注意してください。環境変数または
.envファイルで管理し、.gitignoreに追加してください。 - Google Calendar APIの無料枠は1日あたり1,000,000リクエストです。通常の個人・業務利用では超過しません。
- 初回認証時に発行されるリフレッシュトークンはセキュアな場所に保管してください。
- このサーバーはコミュニティ版です。Google公式ではないため、機能の安定性や継続的なメンテナンスは開発者コミュニティに依存します。
主なユースケース
- 来週の空き時間をAIに確認させてミーティング候補を提示する
- 「明日の14時にチームミーティング」をAIへの一言でカレンダーに登録する
- 今週のスケジュールをAIが一覧表示して優先度を整理する
- 特定期間のイベントをAIが検索して時間の使い方を分析する
プラットフォーム別の注意事項
- Windows:PowerShellで環境変数を設定する場合は `$env:GOOGLE_CLIENT_ID = '...'` を使用してください。`.env` ファイルでの管理を推奨します。
- プロキシ環境:社内プロキシ環境では `HTTPS_PROXY` 環境変数を合わせて設定してください。Google OAuthのエンドポイントへのアクセスが必要です。