Cal.com MCP

resmi

Hubungkan klien AI ke penjadwalan Cal.com melalui Model Context Protocol menggunakan server yang dihosting di mcp.cal.com atau instance lokal.

Lihat di cal.com

Apa yang bisa Anda lakukan dengan 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.

Dokumentasi

Server MCP

Hubungkan klien AI ke penjadwalan Cal.com melalui Model Context Protocol menggunakan server yang dihosting di mcp.cal.com atau instans lokal.

Server MCP Cal.com membungkus API Cal.com v2 dalam Model Context Protocol, memungkinkan Anda mengelola pemesanan, jenis acara, jadwal, dan lainnya melalui bahasa alami di klien yang kompatibel dengan MCP.

Server yang dihosting (mcp.cal.com)

Cara tercepat untuk memulai adalah menghubungkan klien MCP Anda langsung ke mcp.cal.com. Server yang dihosting menggunakan transport HTTP Streamable dengan autentikasi OAuth 2.1 — klien Anda menangani alur otorisasi secara otomatis.

Hubungkan klien Anda

Arahkan klien MCP Anda ke URL server yang dihosting:

https://mcp.cal.com/mcp

Saat pertama kali terhubung, klien Anda memandu Anda melalui alur otorisasi OAuth di mana Anda memberikan akses server ke akun Cal.com Anda. Tidak diperlukan kunci API.

Tambahkan yang berikut ke `claude_desktop_config.json` Anda:

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

Buka **Pengaturan → MCP** dan tambahkan server baru dengan URL `https://mcp.cal.com/mcp`, atau tambahkan ke `.cursor/mcp.json` Anda:

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

Tambahkan server ke pengaturan MCP VS Code Anda:

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

Server self-hosted (stdio)

Jika Anda lebih suka menjalankan server secara lokal, Anda dapat menggunakan transport stdio dengan kunci API. Ini berguna untuk pengembangan atau ketika Anda menginginkan kontrol penuh atas server.

Prasyarat

Node.js >= 18
Kunci API Cal.com — buat di Pengaturan → Pengembang → Kunci API

Hubungkan klien Anda

Tambahkan yang berikut ke konfigurasi klien MCP Anda:

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

Ganti cal_live_xxxx dengan kunci API Anda yang sebenarnya.

Jangan pernah membagikan atau meng-commit kunci API Anda. Jika terekspos, segera rotasi di [pengaturan Cal.com](https://app.cal.com/settings/developer/api-keys) Anda.

Alat yang tersedia

Server MCP menyediakan 34 alat yang diatur berdasarkan kategori:

Profil pengguna

Alat	Deskripsi
`get_me`	Dapatkan profil pengguna terautentikasi Anda
`update_me`	Perbarui profil pengguna Anda

Jenis acara

Alat	Deskripsi
`get_event_types`	Daftar semua jenis acara
`get_event_type`	Dapatkan jenis acara tertentu berdasarkan ID
`create_event_type`	Buat jenis acara baru
`update_event_type`	Perbarui jenis acara
`delete_event_type`	Hapus jenis acara

Pemesanan

Alat	Deskripsi
`get_bookings`	Daftar pemesanan dengan filter opsional
`get_booking`	Dapatkan pemesanan tertentu berdasarkan UID
`create_booking`	Buat pemesanan baru
`reschedule_booking`	Jadwalkan ulang pemesanan
`cancel_booking`	Batalkan pemesanan
`confirm_booking`	Konfirmasi pemesanan yang tertunda
`mark_booking_absent`	Tandai ketidakhadiran pemesanan
`get_booking_attendees`	Dapatkan semua peserta untuk pemesanan
`add_booking_attendee`	Tambahkan peserta ke pemesanan
`get_booking_attendee`	Dapatkan peserta tertentu

Jadwal

Alat	Deskripsi
`get_schedules`	Daftar semua jadwal
`get_schedule`	Dapatkan jadwal tertentu berdasarkan ID
`create_schedule`	Buat jadwal baru
`update_schedule`	Perbarui jadwal
`delete_schedule`	Hapus jadwal
`get_default_schedule`	Dapatkan jadwal default Anda

Ketersediaan

Alat	Deskripsi
`get_availability`	Dapatkan slot waktu yang tersedia
`get_busy_times`	Dapatkan waktu sibuk dari kalender

Konferensi

Alat	Deskripsi
`get_conferencing_apps`	Daftar aplikasi konferensi

Formulir perutean

Alat	Deskripsi
`calculate_routing_form_slots`	Hitung slot berdasarkan respons formulir perutean

Organisasi

Alat	Deskripsi
`get_org_memberships`	Dapatkan semua keanggotaan organisasi
`create_org_membership`	Buat keanggotaan organisasi
`get_org_membership`	Dapatkan keanggotaan organisasi
`delete_org_membership`	Hapus keanggotaan organisasi
`get_org_routing_forms`	Dapatkan formulir perutean organisasi
`get_org_routing_form_responses`	Dapatkan respons formulir perutean

Contoh prompt

Setelah terhubung, Anda dapat berinteraksi dengan Cal.com menggunakan bahasa alami:

"Pemesanan apa yang saya miliki minggu ini?"
"Buat jenis acara 30 menit bernama 'Obrolan Singkat'"
"Batalkan pertemuan saya dengan John besok"
"Tampilkan slot yang tersedia untuk hari Senin depan"
"Jadwalkan ulang pertemuan jam 2 siang saya ke hari Kamis jam 3 sore"
"Jenis acara apa yang saya miliki?"

Sumber daya terkait

Panduan agen AI — bangun agen AI menggunakan API Cal.com secara langsung
Referensi API v2 — dokumentasi endpoint API lengkap
Repositori GitHub — kode sumber