Cal.com MCP

resmi

AI istemcilerini, mcp.cal.com adresindeki barındırılan sunucu veya yerel bir örnek aracılığıyla Model Bağlam Protokolü kullanarak Cal.com planlamasına bağlayın.

cal.com üzerinde görüntüle

Cal Com MCP ile neler yapabilirsiniz?

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.

Dokümantasyon

MCP sunucusu

mcp.cal.com adresindeki barındırılan sunucuyu veya yerel bir örneği kullanarak Model Context Protocol aracılığıyla yapay zeka istemcilerini Cal.com zamanlamasına bağlayın.

Cal.com MCP sunucusu, Cal.com API v2'yi Model Context Protocol içinde sararak, MCP uyumlu herhangi bir istemcide doğal dil aracılığıyla rezervasyonları, etkinlik türlerini, programları ve daha fazlasını yönetmenizi sağlar.

Barındırılan sunucu (mcp.cal.com)

Başlamanın en hızlı yolu, MCP istemcinizi doğrudan mcp.cal.com adresine bağlamaktır. Barındırılan sunucu, OAuth 2.1 kimlik doğrulaması ile Streamable HTTP aktarımını kullanır — istemciniz yetkilendirme akışını otomatik olarak yönetir.

İstemcinizi bağlayın

MCP istemcinizi barındırılan sunucu URL'sine yönlendirin:

https://mcp.cal.com/mcp

İlk bağlandığınızda, istemciniz size sunucuya Cal.com hesabınıza erişim izni verdiğiniz bir OAuth yetkilendirme akışında rehberlik eder. API anahtarına gerek yoktur.

`claude_desktop_config.json` dosyanıza aşağıdakini ekleyin:

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

**Ayarlar → MCP**'yi açın ve `https://mcp.cal.com/mcp` URL'si ile yeni bir sunucu ekleyin veya `.cursor/mcp.json` dosyanıza ekleyin:

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

Sunucuyu VS Code MCP ayarlarınıza ekleyin:

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

Kendi kendine barındırılan sunucu (stdio)

Sunucuyu yerel olarak çalıştırmayı tercih ederseniz, bir API anahtarı ile stdio aktarımını kullanabilirsiniz. Bu, geliştirme için veya sunucu üzerinde tam kontrol istediğinizde kullanışlıdır.

Ön koşullar

Node.js >= 18
Bir Cal.com API anahtarı — Ayarlar → Geliştirici → API Anahtarları bölümünden oluşturun

İstemcinizi bağlayın

MCP istemcinizin yapılandırmasına aşağıdakini ekleyin:

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

cal_live_xxxx kısmını gerçek API anahtarınızla değiştirin.

API anahtarınızı asla paylaşmayın veya commit etmeyin. Açığa çıkarsa, [Cal.com ayarlarınızdan](https://app.cal.com/settings/developer/api-keys) hemen yeniden oluşturun.

Kullanılabilir araçlar

MCP sunucusu, kategoriye göre düzenlenmiş 34 araç sunar:

Kullanıcı profili

Araç	Açıklama
`get_me`	Kimliği doğrulanmış kullanıcı profilinizi alın
`update_me`	Kullanıcı profilinizi güncelleyin

Etkinlik türleri

Araç	Açıklama
`get_event_types`	Tüm etkinlik türlerini listele
`get_event_type`	Belirli bir etkinlik türünü ID ile al
`create_event_type`	Yeni bir etkinlik türü oluştur
`update_event_type`	Bir etkinlik türünü güncelle
`delete_event_type`	Bir etkinlik türünü sil

Rezervasyonlar

Araç	Açıklama
`get_bookings`	İsteğe bağlı filtrelerle rezervasyonları listele
`get_booking`	Belirli bir rezervasyonu UID ile al
`create_booking`	Yeni bir rezervasyon oluştur
`reschedule_booking`	Bir rezervasyonu yeniden zamanla
`cancel_booking`	Bir rezervasyonu iptal et
`confirm_booking`	Bekleyen bir rezervasyonu onayla
`mark_booking_absent`	Bir rezervasyonu yokluk olarak işaretle
`get_booking_attendees`	Bir rezervasyon için tüm katılımcıları al
`add_booking_attendee`	Bir rezervasyona katılımcı ekle
`get_booking_attendee`	Belirli bir katılımcıyı al

Programlar

Araç	Açıklama
`get_schedules`	Tüm programları listele
`get_schedule`	Belirli bir programı ID ile al
`create_schedule`	Yeni bir program oluştur
`update_schedule`	Bir programı güncelle
`delete_schedule`	Bir programı sil
`get_default_schedule`	Varsayılan programınızı al

Uygunluk

Araç	Açıklama
`get_availability`	Uygun zaman aralıklarını al
`get_busy_times`	Takvimlerden meşgul zamanları al

Konferans

Araç	Açıklama
`get_conferencing_apps`	Konferans uygulamalarını listele

Yönlendirme formları

Araç	Açıklama
`calculate_routing_form_slots`	Yönlendirme formu yanıtına göre aralıkları hesapla

Organizasyonlar

Araç	Açıklama
`get_org_memberships`	Tüm organizasyon üyeliklerini al
`create_org_membership`	Bir organizasyon üyeliği oluştur
`get_org_membership`	Bir organizasyon üyeliğini al
`delete_org_membership`	Bir organizasyon üyeliğini sil
`get_org_routing_forms`	Organizasyon yönlendirme formlarını al
`get_org_routing_form_responses`	Yönlendirme formu yanıtlarını al

Örnek istemler

Bağlandıktan sonra, doğal dil kullanarak Cal.com ile etkileşime geçebilirsiniz:

"Bu hafta hangi rezervasyonlarım var?"
"'Hızlı Sohbet' adında 30 dakikalık bir etkinlik türü oluştur"
"Yarın John ile olan toplantımı iptal et"
"Önümüzdeki Pazartesi için uygun zaman aralıklarımı göster"
"Saat 14:00'teki toplantımı Perşembe saat 15:00'e yeniden zamanla"
"Hangi etkinlik türlerim var?"

İlgili kaynaklar

Yapay zeka aracıları kılavuzu — Cal.com API'sini doğrudan kullanarak yapay zeka aracıları oluşturun
API v2 referansı — tam API uç noktası belgeleri
GitHub deposu — kaynak kodu