Google Calendar MCP Server

Google カレンダーとは

Google カレンダーは、Googleアカウントがあれば誰でも無料で使えるスケジュール管理サービスです。仕事のミーティングも、プライベートの予定も、ブラウザやスマホアプリで一括管理できます。

会議の招待、リマインダー通知、他のメンバーとの共有まで、すべて1つのカレンダーで完結します。世界中で個人・チームのスケジュール管理に最も広く使われているサービスのひとつです。

Google カレンダー × AI でできること

このMCPサーバーを導入すると、Google カレンダーの予定をAIへの一言で操作できます。

🔍 確認する

「今週の予定を全部教えて」
→ Google カレンダーから今週分の予定を一覧で取得・表示

🗓️ 作成する

「明日14時から1時間で『プロダクトレビュー』を作成、team@example.comを招待して」
→ 指定の日時・参加者で新規イベントを作成

🕓 探す

「来週の平日で1時間以上空いてる時間を教えて」
→ カレンダーの空き時間を検索して候補を提示

✏️ 変更する

「金曜16時の会議を17時にずらして」
→ 該当イベントの開始時刻を更新

提供される主なツール

ツール	機能
list-calendars	利用可能なカレンダー一覧を取得
list-events	期間指定で予定を一覧取得
get-event	予定IDから詳細を取得
search-events	テキスト検索で予定を探す
create-event	新規予定を作成
update-event	既存予定を更新
delete-event	予定を削除
get-freebusy	複数カレンダーの空き時間をチェック

このほか、招待返信・色一覧取得・マルチアカウント管理などのユーティリティも含まれます。

Google Calendar MCP Server について

Google Calendar MCP Server は、コミュニティが開発した MCP サーバーです（Google 社公式ではありません）。Google Calendar API を経由してイベントの作成・検索・更新・削除を AI エージェントから実行できます。

会議調整やスケジュール確認をいちいちカレンダーアプリを開いて行う代わりに、AI チャットの中で完結できる構成。「明日 14 時から会議」「来週空いてる日」のような自然な依頼でカレンダー操作を進める用途に向きます。

スペック

• 配布形態: npm パッケージ @cocal/google-calendar-mcp（npx 起動）
• 認証: Google OAuth（Google Cloud Console で「デスクトップアプリ」型 OAuth クライアントを作成し、認証情報 JSON を GOOGLE_OAUTH_CREDENTIALS で指定）
• 提供元: コミュニティ製（nspady / cocal namespace / MIT ライセンス）
• 対応範囲: Google Calendar の予定 CRUD・空き時間検索・マルチアカウント管理

導入手順

前提条件

• Node.js（npx が利用できる環境）
• Googleアカウント
• Google Cloud Consoleでの「デスクトップアプリ」型OAuthクライアント作成

ステップ

1. Google Cloud Console で新しいプロジェクトを作成（または既存を使用）
2. "APIとサービス" → "ライブラリ" で Google Calendar API を有効化
3. "APIとサービス" → "認証情報" で OAuth 2.0 クライアントID を作成（アプリケーションの種類: デスクトップアプリ。デスクトップアプリはリダイレクト URI の手動設定は不要です）
4. 作成した認証情報の JSON をダウンロードし、gcp-oauth.keys.json 等の名前で保存
5. ページ上部のタブから使用環境（Claude Desktop / Cursor / Cline）を選択し、JSON設定をコピー
6. GOOGLE_OAUTH_CREDENTIALS の値を、保存した認証情報ファイルの絶対パスに置き換え
7. コピーしたJSONを設定ファイル（claude_desktop_config.json など）に追記して保存
8. クライアントを再起動
9. 初回起動時にブラウザでGoogle認証が求められます。指示に従って承認してください

注意事項

• 認証情報ファイル（gcp-oauth.keys.json）はソースコードやチャット履歴に含めないよう注意してください。安全な場所に保管し、.gitignore に追加してください。
• Google Calendar APIの無料枠は1日あたり1,000,000リクエストです。通常の個人・業務利用では超過しません。
• 初回認証時に発行されるリフレッシュトークンはセキュアな場所に保管してください。
• このサーバーはコミュニティ版です。Google公式ではないため、機能の安定性や継続的なメンテナンスは開発者コミュニティに依存します。

{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": ["-y", "@cocal/google-calendar-mcp"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "/path/to/gcp-oauth.keys.json"
      }
    }
  }
}

{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": ["-y", "@cocal/google-calendar-mcp"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "/path/to/gcp-oauth.keys.json"
      }
    }
  }
}

{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": ["-y", "@cocal/google-calendar-mcp"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "/path/to/gcp-oauth.keys.json"
      }
    }
  }
}