Google Calendar MCP

Google Calendar MCP

英語 | ロシア語

A1 Google Calendar MCPを使うと、AI アプリから自然な言葉で Google Calendar を管理できます。今週の予定を確認したり、ゲストと Google Meet のリンクを含めて会議を設定したり、予定を変更・キャンセルしたり、全員の空いている時間を探したり、外出中や集中時間をブロックしたりできます。

Google アカウントで Google Calendar API を使用します。定期的な予定のシリーズ全体と、単一の予定を区別し、Calendar API ですべてのカレンダー操作が可能であるかのように装うのではなく、その制限を明確にします。

• 19 個のツール。 カレンダー、予定、空き時間情報の確認、予定の作成と編集、定期的な予定シリーズの展開、外出中や集中時間のブロックに加え、Google アカウントへの接続用ツールが 6 個あります。
• チャットからサインイン。 手書きの認証情報ファイルは不要です。アシスタントに接続を依頼し、ブラウザーでアクセスを承認すれば、再起動せずに次のリクエストから使えます。クライアントシークレットはファイルパスとして渡され、会話を通じて送信されることはありません。
• 誤ってメールが送信されることはありません。 招待、変更、キャンセルについて Calendar API のデフォルトではメールは送信されません。send_updates で依頼した場合にのみ、ゲストにメールが送信されます。
• 書き込み操作は再実行されません。 曖昧な失敗が発生しても、サーバーは書き込みを再試行しません。予定が重複すると、すべてのゲストにメールが再送信される可能性があるためです。
• Google のスコープは最小限。 広範な calendar スコープは使わず、calendar.events と calendar.readonly を使用します。

まずは、読み取り専用の質問から始めましょう。

今週のカレンダーの予定は何ですか？重複している会議があれば教えてください。

サーバーに接続する · ユースケースを見る · 技術ドキュメントを開く

1 分で動作を確認

あなた： 木曜日はどんな予定ですか？Anna と私の両方が空いている時間はいつですか？

アシスタント： 木曜日の予定と、あなたと Anna の両方が空いている時間を表示します。予定は変更されません。

あなた： 最初に二人とも空いている時間に、Anna との 45 分間のデザインレビューを Google Meet のリンク付きで予約してください。

アシスタント： 予定の候補日時、ゲスト一覧、Meet のリンクを表示し、予定を作成する前に確認を求めます。

あなた： 確定してください。

アシスタント： 予定を作成します。招待メールの送信を依頼しない限り、誰にもメールは送信されません。

目次

• クイックスタート
• 依頼できること
• 予定の変更方法
• 変更できる内容
• アクセス権の取得
• 設定
• データ、制限、バックグラウンド処理
• 技術ドキュメント
• サポート

クイックスタート

Node.js 20 以降、Google アカウント、および Google Calendar API を有効にした Google Cloud プロジェクトの OAuth 認証情報が必要です。

1. Google OAuth アクセスを準備する。
2. MCP サーバーを AI アプリに追加します。
3. 上記の読み取り専用の質問をします。

codex mcp add google-calendar \
  --env GOOGLE_CALENDAR_CLIENT_ID=your_client_id \
  --env GOOGLE_CALENDAR_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_CALENDAR_REFRESH_TOKEN=your_refresh_token \
  -- npx -y @a1-x-tech/mcp-google-calendar@latest

codex mcp list

claude mcp add \
  --env GOOGLE_CALENDAR_CLIENT_ID=your_client_id \
  --env GOOGLE_CALENDAR_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_CALENDAR_REFRESH_TOKEN=your_refresh_token \
  --transport stdio --scope user google-calendar \
  -- npx -y @a1-x-tech/mcp-google-calendar@latest

claude mcp list

{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": ["-y", "@a1-x-tech/mcp-google-calendar@latest"],
      "env": {
        "GOOGLE_CALENDAR_CLIENT_ID": "your_client_id",
        "GOOGLE_CALENDAR_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_CALENDAR_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

{
  "mcpServers": {
    "google-calendar": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@a1-x-tech/mcp-google-calendar@latest"],
      "env": {
        "GOOGLE_CALENDAR_CLIENT_ID": "your_client_id",
        "GOOGLE_CALENDAR_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_CALENDAR_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

{
  "servers": {
    "google-calendar": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@a1-x-tech/mcp-google-calendar@latest"],
      "env": {
        "GOOGLE_CALENDAR_CLIENT_ID": "${input:calendar_client_id}",
        "GOOGLE_CALENDAR_CLIENT_SECRET": "${input:calendar_client_secret}",
        "GOOGLE_CALENDAR_REFRESH_TOKEN": "${input:calendar_refresh_token}"
      }
    }
  },
  "inputs": [
    { "type": "promptString", "id": "calendar_client_id", "description": "Google OAuth client ID" },
    { "type": "promptString", "id": "calendar_client_secret", "description": "Google OAuth client secret", "password": true },
    { "type": "promptString", "id": "calendar_refresh_token", "description": "Google OAuth refresh token", "password": true }
  ]
}

できること

スケジュールを確認する

• 今週の会議を教えてください。定期的な会議も含めてください。
• 明日の1対1の会議について、ゲスト、Meet のリンク、リマインダーを表示してください。
• 3月のチーム同期の予定をすべて一覧表示してください。

会議を計画・変更する

• 木曜日に、ゲスト2人と Google Meet のリンクを含む45分のレビュー会議を作成してください。
• レトロスペクティブを1時間遅らせて、ゲストリストを更新してください。ただし、まだ誰にもメールを送らないでください。
• 計画会議をチームのカレンダーに移動してください。
• 金曜日のスタンドアップだけをキャンセルし、シリーズのほかの予定はそのままにしてください。

自分の時間を守る

• 来週、Anna、Boris、私の全員が1時間空いているのはいつですか？
• 休暇中の不在予定を登録し、新しい招待を自動的に辞退してください。
• 明日の朝に2時間の集中時間を作成し、Google Chat の通知をミュートしてください。

イベントの変更方法

1. calendar_id: "primary" はメインカレンダーです。それ以外のカレンダーは list_calendars から取得でき、書き込みには編集者アクセス権が必要です。
2. 定期的なシリーズと単一の予定では ID が異なります。シリーズ ID を使うとすべての予定が変更またはキャンセルされ、インスタンス ID（list_event_instances から取得）を使うと特定の予定だけが変更されます。
3. update_event で変更されるのは指定したフィールドだけですが、ネストされたオブジェクトは以前の内容全体を置き換えます。新しい attendees リストを指定すると、ゲストリスト全体が置き換えられます。
4. send_updates で指定しない限り、書き込みによってメールが送信されることはありません。Calendar API のデフォルトでは通知されません。

不在（Out of Office）と集中時間のブロックを作成できるのは、Google Workspace アカウントのメインカレンダーのみです。個人用 Gmail とセカンダリカレンダーでは拒否されます。イベントの作成時に競合は確認されないため、まず空き状況を確認してください。終日イベントの終了日は含まれません。金曜日までのイベントは、土曜日の日付で終了します。

変更できる内容

確認プロンプトは AI クライアントが制御します。サーバーは読み取り、書き込み、削除系のツールを区別できるようにマークしているため、クライアントは状態の確認と実際の変更を見分けられます。

アクセスの取得

自分のカレンダーにアクセスするには OAuth 2.0 が必要です。API キーだけでは不十分です。接続方法は 2 つあり、1 つ目の方法では設定ファイルは一切必要ありません。

チャットからサインインする

認証情報なしでサーバーを起動し、アシスタントに接続を依頼します。次の 6 つの組み込みツールを使って手順を案内します。

ログインするとすぐに有効になり、AI クライアントを再起動せずに次のツール呼び出しを実行できます。トークンは ~/.config/mcp-google-calendar/credentials.json（Windows では %APPDATA% 以下）に保存されます。ファイルを読み取れるのは自分のアカウントだけで、マシンの外に送信されることはありません。

環境変数を設定する方法

従来の方法で、CI やヘッドレスインストールではこちらを使用してください。

1. Google Cloud プロジェクトを作成または選択し、Google Calendar API を有効にします。

2. OAuth 同意画面を設定し、Desktop app の OAuth クライアントを作成します。

3. 管理するカレンダーがある Google アカウントを承認します。Use your own OAuth credentials を有効にすると、OAuth 2.0 Playground でリフレッシュトークンを取得できます。

4. 次の両方のスコープをリクエストします。

   https://www.googleapis.com/auth/calendar.events
   https://www.googleapis.com/auth/calendar.readonly
   

   広範な https://www.googleapis.com/auth/calendar スコープが必要なのは、カレンダーや共有ルール自体を管理する raw_request 呼び出しのみです。

環境変数はチャットで行ったログインより常に優先されるため、既存の設定済みインストールはこれまでとまったく同じように動作します。

テストモードの OAuth リフレッシュトークンは、7 日後に期限切れになる場合があります。長期間アクセスする必要がある場合は、OAuth アプリを公開するか、Workspace ドメインで Internal アプリを使用してください。クライアントシークレットとリフレッシュトークンはパスワードとして扱ってください。

設定

* OAuth の 3 つの値、またはアクセストークンのいずれかを指定してください。認証情報がなくてもサーバーは起動して MCP ハンドシェイクを完了しますが、最初のツール呼び出し時に設定すべき正確な変数名が示されます。

データ、制限、バックグラウンド処理

• リクエストは Google Calendar に送信されます。 ローカルサーバーは Google OAuth トークンを更新し、Calendar API を呼び出します。匿名テレメトリに含まれるのは、インストール ID、パッケージバージョン、AI クライアントとプラットフォームのバージョン、ツール名のみです。OAuth トークン、カレンダーデータ、ツールの引数、プロンプトは含まれません。オプトアウトするには ASKADS_TELEMETRY=0 を設定してください。
• Google はプロジェクトごとのクォータを適用します。 429 が返された場合、サーバーはバックオフして再試行します。読み取りはネットワークエラーや 5xx エラーの後も再試行しますが、失敗が不確かな場合、書き込みは再実行されません。予定が重複すると、すべてのゲストにメールが再送される可能性があるためです。
• バックグラウンドでのポーリングはありません。 サーバーは呼び出されたときのみ動作します。list_events は updated_min による差分チェックに対応しています。AI アプリがスケジュールタスクに対応している場合は、定期的にカレンダーを確認できます。

技術ドキュメント

• MCP 機能カタログ — 各ツールのタスク別ページ。
• すべてのツールと入力
• 開発ドキュメント
• 公開ドキュメント
• Google Calendar API リファレンス

サポート

バグを見つけた場合や、特定の利用シナリオについて相談したい場合は、Issue を作成するか、Telegram でお問い合わせください。

最後まで読んでいただき、ありがとうございます！