Cal.com MCP

公式

Model Context Protocolを使用して、ホストサーバーmcp.cal.comまたはローカルインスタンス経由でAIクライアントをCal.comのスケジューリングに接続します。

cal.com で表示

Cal Com MCPで何ができますか？

  • Check your upcoming bookings — Ask for a list of your bookings with filters like date range or status using get_bookings.
  • Create and manage event types — Create, update, or delete event types such as a "Quick Chat" via create_event_type and related tools.
  • Reschedule or cancel meetings — Reschedule a booking to a new time with reschedule_booking or cancel it entirely with cancel_booking.
  • Find available time slots — Retrieve open slots for a given date range using get_availability before scheduling.
  • Manage your schedules — View, create, or modify your availability schedules with get_schedules and create_schedule.
  • Handle booking attendees — View all attendees for a booking with get_booking_attendees or add new ones with add_booking_attendee.

ドキュメント

MCPサーバー

mcp.cal.comのホスト型サーバーまたはローカルインスタンスを使用して、Model Context Protocol経由でAIクライアントをCal.comのスケジューリングに接続します。

Cal.com MCPサーバーは、Cal.com API v2をModel Context Protocolでラップし、MCP対応クライアントで自然言語を使用して予約、イベントタイプ、スケジュールなどを管理できるようにします。

ホスト型サーバー (mcp.cal.com)

最も早く始める方法は、MCPクライアントをmcp.cal.comに直接接続することです。ホスト型サーバーはOAuth 2.1認証を備えたStreamable HTTPトランスポートを使用し、クライアントが認可フローを自動的に処理します。

クライアントの接続

MCPクライアントをホスト型サーバーのURLに向けます：

https://mcp.cal.com/mcp

初回接続時に、クライアントがOAuth認可フローを案内し、サーバーにCal.comアカウントへのアクセスを許可します。APIキーは不要です。

`claude_desktop_config.json`に以下を追加します： 
* **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

```json theme={null}
{
  "mcpServers": {
    "calcom": {
      "url": "https://mcp.cal.com/mcp"
    }
  }
}
```
**設定 → MCP**を開き、URL `https://mcp.cal.com/mcp`で新しいサーバーを追加するか、`.cursor/mcp.json`に追加します： 
```json theme={null}
{
  "mcpServers": {
    "calcom": {
      "url": "https://mcp.cal.com/mcp"
    }
  }
}
```
VS CodeのMCP設定にサーバーを追加します： 
```json theme={null}
{
  "mcpServers": {
    "calcom": {
      "url": "https://mcp.cal.com/mcp"
    }
  }
}
```

セルフホスト型サーバー (stdio)

サーバーをローカルで実行する場合は、APIキーを使用したstdioトランスポートを利用できます。これは開発時やサーバーを完全に制御したい場合に便利です。

前提条件

クライアントの接続

MCPクライアントの設定に以下を追加します：

{
  "mcpServers": {
    "calcom": {
      "command": "npx",
      "args": ["@calcom/cal-mcp@latest"],
      "env": {
        "CAL_API_KEY": "cal_live_xxxx"
      }
    }
  }
}

cal_live_xxxxを実際のAPIキーに置き換えてください。

APIキーを共有したりコミットしたりしないでください。漏洩した場合は、[Cal.com設定](https://app.cal.com/settings/developer/api-keys)で直ちにローテーションしてください。

利用可能なツール

MCPサーバーはカテゴリ別に34のツールを公開しています：

ユーザープロフィール

ツール説明
get_me認証済みユーザープロフィールを取得
update_meユーザープロフィールを更新

イベントタイプ

ツール説明
get_event_typesすべてのイベントタイプを一覧表示
get_event_typeIDで特定のイベントタイプを取得
create_event_type新しいイベントタイプを作成
update_event_typeイベントタイプを更新
delete_event_typeイベントタイプを削除

予約

ツール説明
get_bookingsオプションのフィルターで予約を一覧表示
get_bookingUIDで特定の予約を取得
create_booking新しい予約を作成
reschedule_booking予約を再スケジュール
cancel_booking予約をキャンセル
confirm_booking保留中の予約を確認
mark_booking_absent予約の不在をマーク
get_booking_attendees予約の全参加者を取得
add_booking_attendee予約に参加者を追加
get_booking_attendee特定の参加者を取得

スケジュール

ツール説明
get_schedulesすべてのスケジュールを一覧表示
get_scheduleIDで特定のスケジュールを取得
create_schedule新しいスケジュールを作成
update_scheduleスケジュールを更新
delete_scheduleスケジュールを削除
get_default_scheduleデフォルトスケジュールを取得

空き状況

ツール説明
get_availability利用可能な時間枠を取得
get_busy_timesカレンダーからビジー時間を取得

会議

ツール説明
get_conferencing_apps会議アプリケーションを一覧表示

ルーティングフォーム

ツール説明
calculate_routing_form_slotsルーティングフォームの回答に基づいて枠を計算

組織

ツール説明
get_org_membershipsすべての組織メンバーシップを取得
create_org_membership組織メンバーシップを作成
get_org_membership組織メンバーシップを取得
delete_org_membership組織メンバーシップを削除
get_org_routing_forms組織のルーティングフォームを取得
get_org_routing_form_responsesルーティングフォームの回答を取得

プロンプト例

接続すると、自然言語でCal.comを操作できます：

  • 「今週の予約は何がありますか？」
  • 「'Quick Chat'という30分のイベントタイプを作成して」
  • 「明日のJohnとのミーティングをキャンセルして」
  • 「来週の月曜日の空き枠を表示して」
  • 「午後2時のミーティングを木曜日の午後3時に再スケジュールして」
  • 「どんなイベントタイプがありますか？」

関連リソース