Cal.com MCP

เซิร์ฟเวอร์ MCP

เชื่อมต่อไคลเอนต์ AI เข้ากับการจัดตารางนัดหมายของ Cal.com ผ่าน Model Context Protocol โดยใช้เซิร์ฟเวอร์ที่โฮสต์อยู่ที่ mcp.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"
    }
  }
}
```

เปิด **Settings → 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 สิ่งนี้มีประโยชน์สำหรับการพัฒนาหรือเมื่อคุณต้องการควบคุมเซิร์ฟเวอร์อย่างเต็มที่

ข้อกำหนดเบื้องต้น

• Node.js >= 18
• คีย์ Cal.com API — สร้างได้ใน Settings → Developer → API Keys

เชื่อมต่อไคลเอนต์ของคุณ

เพิ่มสิ่งต่อไปนี้ลงในการกำหนดค่าไคลเอนต์ 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 นาทีชื่อ 'Quick Chat'"
• "ยกเลิกการประชุมของฉันกับ John ในวันพรุ่งนี้"
• "แสดงช่วงเวลาที่ว่างของฉันสำหรับวันจันทร์หน้า"
• "กำหนดเวลาการประชุมบ่าย 2 โมงของฉันใหม่เป็นวันพฤหัสบดีเวลา 3 โมง"
• "ฉันมีประเภทกิจกรรมอะไรบ้าง"

แหล่งข้อมูลที่เกี่ยวข้อง

• คู่มือเอเจนต์ AI — สร้างเอเจนต์ AI โดยใช้ Cal.com API โดยตรง
• ข้อมูลอ้างอิง API v2 — เอกสารประกอบปลายทาง API ฉบับเต็ม
• ที่เก็บ GitHub — ซอร์สโค้ด