Cal.com MCP

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 API Cal.com 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 khách tương thích MCP 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 khách 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ể truyền phát với xác thực OAuth 2.1 — ứng dụng khách của bạn sẽ tự động xử lý luồng ủ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ủ được 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 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 khách của bạn

Thêm phần 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.

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 nó 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ê các đặ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ờ khả dụng
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ụ 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 chỗ nào trong tuần này?"
• "Tạo một loại sự kiện 30 phút có tên '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 tới"
• "Lên lịch lạ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 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