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.comDùng thử MCP nàyĐược tài trợ

Bạn có thể làm gì với Cal Com MCP?

Quản lý đặt lịch — Yêu cầu trợ lý của bạn liệt kê, tạo, dời lịch hoặc hủy đặt lịch bằng các công cụ như get_bookings và create_booking.
Cấu hình loại sự kiện — Tạo hoặc cập nhật loại sự kiện, chẳng hạn như "Trò chuyện nhanh" 30 phút, qua create_event_type và update_event_type.
Kiểm tra khả dụng — Truy vấn các khung giờ trống hoặc khoảng thời gian bận từ lịch đã kết nối bằng get_availability và get_busy_times.
Xử lý lịch biểu — Tạo, cập nhật hoặc lấy lịch biểu mặc định của bạn bằng create_schedule và get_default_schedule.
Quản lý nhóm và tư cách thành viên — Mời thành viên hoặc điều chỉnh vai trò nhóm qua create_team_invite và update_team_membership.

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 (Model Context Protocol) bằng máy chủ lưu trữ tại mcp.cal.com hoặc một 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 lịch, loại sự kiện, lịch biểu và nhiều hơn nữa thông qua ngôn ngữ tự nhiên trong bất kỳ ứng dụng khách tương thích MCP nào.

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

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

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

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

https://mcp.cal.com/mcp

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

Thêm nội dung 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ột 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"
    }
  }
}
```

Thêm nội dung sau vào `~/.fx/mcp.json` của bạn:

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

Sau đó chạy `/mcp auth calcom --open` trong fx để ủy quyền. Xem
[tài liệu MCP của fx](https://fx.sh/docs/capabilities/mcp) để biết về các giao thức truyền tải,
tùy chọn xác thực và khám phá công cụ.

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 giao thức truyền tải stdio với khóa API. Điều này hữu ích cho 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 khách của bạn

Thêm nội dung sau vào cấu hình ứng dụng khách 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.

Cảnh báo

Không bao giờ chia sẻ hoặc cam kết khóa API của bạn. Nếu bị lộ, hãy xoay vòng khóa ngay lập tức trong cài đặt Cal.com của bạn.

Bộ công cụ

Bạn có thể giới hạn các công cụ mà máy chủ đăng ký cho một phiên bằng cách thêm tham số truy vấn toolsets vào URL máy chủ:

https://mcp.cal.com/mcp?toolsets=bookings,availability

Các bộ công cụ hợp lệ: profile, event-types, bookings, availability, schedules, calendars, teams, organizations, routing-forms, catalog (các công cụ siêu dữ liệu find_api_operation / describe_api_operation / call_api_operation). Các tên không xác định sẽ bị từ chối với 400 invalid_request. Bỏ qua tham số sẽ đăng ký mọi công cụ; các công cụ cục bộ get_app_link và search_docs luôn được đăng ký bất kể lựa chọn. Đối với máy chủ stdio tự lưu trữ, hãy đặt MCP_TOOLSETS thay thế.

Các công cụ có sẵn

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

Liên kết ứng dụng

Công cụ	Mô tả
`get_app_link`	Xây dựng URL mở trang đặt lịch, loại sự kiện, lịch biểu, nhóm, biểu mẫu định tuyến hoặc trang cài đặt trong ứng dụng web Cal.com

Tài liệu

Công cụ	Mô tả
`search_docs`	Tìm kiếm tài liệu sản phẩm Cal.com; trả về các trang được xếp hạng kèm trích đoạn của kết quả hàng đầu

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
`get_event_type_settings`	Lấy cài đặt của một loại sự kiện
`get_event_type_history`	Lấy lịch sử thay đổi của một loại sự kiện
`get_scheduling_config`	Lấy cấu hình lập lịch của một loại sự kiện
`get_crm_sync_errors`	Lấy lỗi đồng bộ CRM cho một loại sự kiện

Đặt lịch

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

Lịch biểu

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

Khả dụng & lịch

Công cụ	Mô tả
`get_availability`	Lấy các khung giờ khả dụng
`get_busy_times`	Lấy thời gian bận từ lịch
`get_connected_calendars`	Liệt kê các lịch đã kết nối
`get_conferencing_apps`	Liệt kê các ứng dụng hội nghị

Nhóm & tư cách thành viên

Công cụ	Mô tả
`get_my_teams`	Lấy các nhóm bạn thuộc về
`get_org_teams`	Lấy các nhóm tổ chức
`create_team_invite`	Mời ai đó vào một nhóm
`create_team_membership`	Tạo tư cách thành viên nhóm
`get_team_memberships`	Lấy tất cả tư cách thành viên nhóm
`get_team_membership`	Lấy một tư cách thành viên nhóm
`update_team_membership`	Cập nhật một tư cách thành viên nhóm
`delete_team_membership`	Xóa một tư cách thành viên nhóm

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 một tư cách thành viên tổ chức
`get_org_membership`	Lấy một tư cách thành viên tổ chức
`update_org_membership`	Cập nhật một tư cách thành viên tổ chức
`delete_org_membership`	Xóa một tư cách thành viên tổ chức
`get_org_attributes`	Lấy các thuộc tính tổ chức
`get_org_attribute`	Lấy một thuộc tính tổ chức
`get_attribute_options`	Lấy các tùy chọn cho một thuộc tính
`get_user_attributes`	Lấy các thuộc tính được gán cho một người dùng
`assign_attribute_to_user`	Gán một thuộc tính cho một người dùng
`update_user_attribute`	Cập nhật một thuộc tính được gán cho một người dùng
`unassign_attribute_from_user`	Hủy gán một thuộc tính khỏi một người dùng
`get_user_attribute_history`	Lấy lịch sử gán thuộc tính của một người dùng

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
`get_org_routing_forms`	Lấy các biểu mẫu định tuyến của tổ chức
`get_org_routing_form_responses`	Lấy các phản hồi biểu mẫu định tuyến

Danh mục API

Công cụ	Mô tả
`find_api_operation`	Tìm kiếm toàn bộ danh mục thao tác API v2
`describe_api_operation`	Lấy lược đồ đầu vào cho một thao tác API
`call_api_operation`	Thực thi bất kỳ thao tác API v2 nào từ danh mục

Ví dụ về 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 lị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 của tôi với John vào ngày mai"
"Hiển thị các khung giờ khả dụng của tôi cho thứ Hai tuần tới"
"Dời cuộc họp lúc 2 giờ chiều của tôi 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 về tác nhân AI — xây dựng tác nhân AI sử dụng trực tiếp Cal.com API
Tài liệu tham khảo API v2 — tài liệu đầy đủ về các điểm cuối API
Kho lưu trữ GitHub — mã nguồn

Tài liệu này được xây dựng và lưu trữ trên Mintlify, một nền tảng tài liệu dành cho nhà phát triển.