Cal.com MCP

MCP sunucusu

Model Context Protocol'ü kullanarak, mcp.cal.com'daki barındırılan sunucu veya yerel bir örnek 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'ye 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 Cal.com hesabınıza sunucu erişimi verdiğiniz bir OAuth yetkilendirme akışında rehberlik eder. API anahtarına gerek yoktur.

Aşağıdakini `claude_desktop_config.json`'nıza 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`'nı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 bir tane 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'i 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 döndürün.

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	Kimliğe göre belirli bir etkinlik türünü 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	UID'ye göre belirli bir rezervasyonu 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 rezervasyon yokluğunu 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	Kimliğe göre belirli bir programı 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

Müsaitlik

Araç	Açıklama
get_availability	Müsait 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şim kurabilirsiniz:

• "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 müsait 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