Cal.com MCP

官方

透過 Model Context Protocol，將 AI 客戶端連接到 Cal.com 排程，可使用 mcp.cal.com 上的託管伺服器或本地實例。

造訪 cal.com

你可以用 Cal Com MCP 做什麼？

  • Check your bookings — Ask for upcoming or past bookings using get_bookings with date or status filters.
  • Manage event types — Create, update, or delete event types via create_event_type, update_event_type, and delete_event_type.
  • Find available slots — Retrieve open time slots with get_availability or check busy periods with get_busy_times.
  • Reschedule or cancel meetings — Modify existing bookings using reschedule_booking or cancel_booking.
  • View and edit schedules — List, create, or update your availability schedules with get_schedules and related tools.
  • Handle booking attendees — View attendees with get_booking_attendees or add someone via add_booking_attendee.

文件

MCP 伺服器

透過 Model Context Protocol，使用託管伺服器 mcp.cal.com 或本地實例，將 AI 客戶端連接到 Cal.com 排程。

Cal.com MCP 伺服器將 Cal.com API v2 包裝在 Model Context Protocol 中，讓您可以在任何相容 MCP 的客戶端中，透過自然語言管理預約、活動類型、行程表等。

託管伺服器 (mcp.cal.com)

最快的入門方式是將您的 MCP 客戶端直接連接到 mcp.cal.com。託管伺服器使用 Streamable HTTP 傳輸和 OAuth 2.1 驗證 — 您的客戶端會自動處理授權流程。

連接您的客戶端

將您的 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)

如果您偏好在本機執行伺服器，可以使用 stdio 傳輸搭配 API 金鑰。這對於開發或希望完全控制伺服器時很有用。

先決條件

連接您的客戶端

將以下內容新增至您的 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_type透過 ID 取得特定活動類型
create_event_type建立新的活動類型
update_event_type更新活動類型
delete_event_type刪除活動類型

預約

工具描述
get_bookings列出預約（可選篩選條件）
get_booking透過 UID 取得特定預約
create_booking建立新的預約
reschedule_booking重新安排預約
cancel_booking取消預約
confirm_booking確認待處理的預約
mark_booking_absent標記預約缺席
get_booking_attendees取得預約的所有參與者
add_booking_attendee將參與者新增至預約
get_booking_attendee取得特定參與者

行程表

工具描述
get_schedules列出所有行程表
get_schedule透過 ID 取得特定行程表
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 互動：

  • "我這週有哪些預約？"
  • "建立一個名為「快速通話」的 30 分鐘活動類型"
  • "取消我明天與 John 的會議"
  • "顯示我下週一的可用時段"
  • "將我下午 2 點的會議重新安排到週四下午 3 點"
  • "我有哪些活動類型？"

相關資源