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.comCoba MCP iniDisponsori

Apa yang bisa Anda lakukan dengan Cal Com MCP?

Periksa pemesanan Anda — Minta pemesanan mendatang atau sebelumnya menggunakan get_bookings dengan filter tanggal atau status.
Kelola jenis acara — Buat, perbarui, atau hapus jenis acara melalui create_event_type, update_event_type, dan delete_event_type.
Temukan slot yang tersedia — Ambil slot waktu yang terbuka dengan get_availability atau periksa periode sibuk dengan get_busy_times.
Jadwalkan ulang atau batalkan pertemuan — Ubah pemesanan yang ada menggunakan reschedule_booking atau cancel_booking.
Lihat dan edit jadwal — Daftar, buat, atau perbarui jadwal ketersediaan Anda dengan get_schedules dan alat terkait.
Kelola peserta pemesanan — Lihat peserta dengan get_booking_attendees atau tambahkan seseorang melalui 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 apa pun yang kompatibel dengan MCP.

Server yang dihosting (mcp.cal.com)

Cara tercepat untuk memulai adalah dengan 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 akan 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 saat Anda menginginkan kontrol penuh atas server.

Prasyarat

Node.js >= 18
Kunci API Cal.com — buat satu 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 rapat saya dengan John besok"
"Tampilkan slot yang tersedia untuk hari Senin depan"
"Jadwalkan ulang rapat jam 2 siang saya ke 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