Cal.com MCP

chính thức

Kết nối các ứng dụng AI với lịch trình Cal.com thông qua Giao thức Ngữ cảnh Mô hình bằng máy chủ lưu trữ tại mcp.cal.com hoặc phiên bản cục bộ.

Xem trên cal.com

Bạn có thể làm gì với 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.

Tài liệu

Máy chủ MCP

Kết nối các ứng dụng AI với lịch trình Cal.com thông qua Giao thức Ngữ cảnh Mô hình bằng máy chủ được lưu trữ tại mcp.cal.com hoặc phiên bản cục bộ.

Máy chủ Cal.com MCP bao bọc Cal.com API v2 trong Giao thức Ngữ cảnh Mô hình, cho phép bạn quản lý đặt chỗ, loại sự kiện, lịch trình và nhiều hơn nữa thông qua ngôn ngữ tự nhiên trong bất kỳ ứng dụng MCP tương thích nào.

Máy chủ được lưu trữ (mcp.cal.com)

Cách nhanh nhất để bắt đầu là kết nối trực tiếp ứng dụng MCP của bạn với mcp.cal.com. Máy chủ được lưu trữ sử dụng truyền tải HTTP có thể phát trực tuyến với xác thực OAuth 2.1 — ứng dụng của bạn sẽ tự động xử lý luồng ủy quyền.

Kết nối ứng dụng của bạn

Trỏ ứng dụng MCP của bạn đến URL máy chủ được lưu trữ:

https://mcp.cal.com/mcp

Khi bạn kết nối lần đầu, ứng dụng sẽ hướng dẫn bạn qua luồng ủy quyền OAuth, nơi bạn cấp cho máy chủ quyền truy cập vào tài khoản Cal.com của mình. Không cần khóa API.

Thêm phần sau vào `claude_desktop_config.json` của bạn:

* **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"
    }
  }
}
```

Mở **Cài đặt → MCP** và thêm máy chủ mới với URL `https://mcp.cal.com/mcp`, hoặc thêm nó vào `.cursor/mcp.json` của bạn:

```json theme={null}
{
  "mcpServers": {
    "calcom": {
      "url": "https://mcp.cal.com/mcp"
    }
  }
}
```

Thêm máy chủ vào cài đặt MCP của VS Code:

```json theme={null}
{
  "mcpServers": {
    "calcom": {
      "url": "https://mcp.cal.com/mcp"
    }
  }
}
```

Máy chủ tự lưu trữ (stdio)

Nếu bạn muốn chạy máy chủ cục bộ, bạn có thể sử dụng truyền tải stdio với khóa API. Điều này hữu ích cho việc phát triển hoặc khi bạn muốn kiểm soát hoàn toàn máy chủ.

Điều kiện tiên quyết

Node.js >= 18
Khóa API Cal.com — tạo một khóa trong Cài đặt → Nhà phát triển → Khóa API

Kết nối ứng dụng của bạn

Thêm phần sau vào cấu hình ứng dụng MCP của bạn:

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

Thay thế cal_live_xxxx bằng khóa API thực tế của bạn.

Không bao giờ chia sẻ hoặc commit khóa API của bạn. Nếu bị lộ, hãy xoay vòng ngay lập tức trong [cài đặt Cal.com](https://app.cal.com/settings/developer/api-keys) của bạn.

Công cụ có sẵn

Máy chủ MCP cung cấp 34 công cụ được tổ chức theo danh mục:

Hồ sơ người dùng

Công cụ	Mô tả
`get_me`	Lấy hồ sơ người dùng đã xác thực của bạn
`update_me`	Cập nhật hồ sơ người dùng của bạn

Loại sự kiện

Công cụ	Mô tả
`get_event_types`	Liệt kê tất cả các loại sự kiện
`get_event_type`	Lấy một loại sự kiện cụ thể theo ID
`create_event_type`	Tạo một loại sự kiện mới
`update_event_type`	Cập nhật một loại sự kiện
`delete_event_type`	Xóa một loại sự kiện

Đặt chỗ

Công cụ	Mô tả
`get_bookings`	Liệt kê đặt chỗ với bộ lọc tùy chọn
`get_booking`	Lấy một đặt chỗ cụ thể theo UID
`create_booking`	Tạo một đặt chỗ mới
`reschedule_booking`	Lên lịch lại một đặt chỗ
`cancel_booking`	Hủy một đặt chỗ
`confirm_booking`	Xác nhận một đặt chỗ đang chờ
`mark_booking_absent`	Đánh dấu vắng mặt cho đặt chỗ
`get_booking_attendees`	Lấy tất cả người tham dự cho một đặt chỗ
`add_booking_attendee`	Thêm người tham dự vào một đặt chỗ
`get_booking_attendee`	Lấy một người tham dự cụ thể

Lịch trình

Công cụ	Mô tả
`get_schedules`	Liệt kê tất cả lịch trình
`get_schedule`	Lấy một lịch trình cụ thể theo ID
`create_schedule`	Tạo một lịch trình mới
`update_schedule`	Cập nhật một lịch trình
`delete_schedule`	Xóa một lịch trình
`get_default_schedule`	Lấy lịch trình mặc định của bạn

Khả dụng

Công cụ	Mô tả
`get_availability`	Lấy các khung giờ có sẵn
`get_busy_times`	Lấy thời gian bận từ lịch

Hội nghị

Công cụ	Mô tả
`get_conferencing_apps`	Liệt kê các ứng dụng hội nghị

Biểu mẫu định tuyến

Công cụ	Mô tả
`calculate_routing_form_slots`	Tính toán các khung giờ dựa trên phản hồi biểu mẫu định tuyến

Tổ chức

Công cụ	Mô tả
`get_org_memberships`	Lấy tất cả tư cách thành viên tổ chức
`create_org_membership`	Tạo tư cách thành viên tổ chức
`get_org_membership`	Lấy tư cách thành viên tổ chức
`delete_org_membership`	Xóa tư cách thành viên tổ chức
`get_org_routing_forms`	Lấy biểu mẫu định tuyến tổ chức
`get_org_routing_form_responses`	Lấy phản hồi biểu mẫu định tuyến

Ví dụ lời nhắc

Sau khi kết nối, bạn có thể tương tác với Cal.com bằng ngôn ngữ tự nhiên:

"Tôi có những đặt chỗ nào trong tuần này?"
"Tạo một loại sự kiện 30 phút tên là 'Trò chuyện nhanh'"
"Hủy cuộc họp với John vào ngày mai"
"Hiển thị các khung giờ có sẵn của tôi cho thứ Hai tới"
"Lên lịch lại cuộc họp lúc 2 giờ chiều sang thứ Năm lúc 3 giờ chiều"
"Tôi có những loại sự kiện nào?"

Tài nguyên liên quan

Hướng dẫn tác nhân AI — xây dựng tác nhân AI sử dụng trực tiếp API Cal.com
Tham khảo API v2 — tài liệu đầy đủ về điểm cuối API
Kho lưu trữ GitHub — mã nguồn