Cal.com MCP

MCP sunucusu

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

Cal.com MCP sunucusu, Cal.com API v2 API'sini Model Context Protocol içinde sarar ve herhangi bir MCP uyumlu 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ıyla Streamable HTTP taşıma protokolü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 bir OAuth yetkilendirme akışı sunar ve burada sunucuya Cal.com hesabınıza erişim izni verirsiniz. API anahtarı gerekmez.

Aşağıdakileri `claude_desktop_config.json` dosyanı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** bölümünü açın ve `https://mcp.cal.com/mcp` URL'siyle 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"
    }
  }
}
```

Aşağıdakileri `~/.fx/mcp.json` dosyanıza ekleyin:

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

Ardından yetkilendirmek için fx içinde `/mcp auth calcom --open` komutunu çalıştırın. Taşıma protokolleri, kimlik doğrulama seçenekleri ve araç keşfi için
[fx MCP belgelerine](https://fx.sh/docs/capabilities/mcp) bakın.

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

Sunucuyu yerel olarak çalıştırmayı tercih ederseniz, API anahtarıyla stdio taşıma protokolünü kullanabilirsiniz. Bu, geliştirme sırasında 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ğıdakileri ekleyin:

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

cal_live_xxxx yerine gerçek API anahtarınızı yazın.

Uyarı

API anahtarınızı asla paylaşmayın veya kaydetmeyin. Açığa çıkarsa, Cal.com ayarlarınızda hemen döndürün.

Araç setleri

Sunucunun bir oturum için kaydettiği araçları kısıtlamak için sunucu URL'sine bir toolsets sorgu parametresi ekleyin:

https://mcp.cal.com/mcp?toolsets=bookings,availability

Geçerli araç setleri: profile, event-types, bookings, availability, schedules, calendars, teams, organizations, routing-forms, catalog (find_api_operation / describe_api_operation / call_api_operation meta araçları). Bilinmeyen adlar 400 invalid_request ile reddedilir. Parametrenin atlanması tüm araçları kaydeder; yerel araçlar get_app_link ve search_docs seçimden bağımsız olarak her zaman kaydedilir. Kendi kendine barındırılan bir stdio sunucusu için bunun yerine MCP_TOOLSETS ayarlayın.

Kullanılabilir araçlar

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

Uygulama bağlantıları

Araç	Açıklama
get_app_link	Cal.com web uygulamasında bir rezervasyon, etkinlik türü, program, ekip, yönlendirme formu veya ayarlar sayfasını açan bir URL oluşturur

Dokümantasyon

Araç	Açıklama
search_docs	Cal.com ürün dokümantasyonunda arama yapar; en iyi sonucun bir alıntısıyla sıralanmış sayfaları döndürür

Kullanıcı profili

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

Etkinlik türleri

Araç	Açıklama
get_event_types	Tüm etkinlik türlerini listeler
get_event_type	Kimliğe göre belirli bir etkinlik türünü alır
create_event_type	Yeni bir etkinlik türü oluşturur
update_event_type	Bir etkinlik türünü günceller
delete_event_type	Bir etkinlik türünü siler
get_event_type_settings	Bir etkinlik türünün ayarlarını alır
get_event_type_history	Bir etkinlik türünün değişiklik geçmişini alır
get_scheduling_config	Bir etkinlik türünün zamanlama yapılandırmasını alır
get_crm_sync_errors	Bir etkinlik türü için CRM senkronizasyon hatalarını alır

Rezervasyonlar

Araç	Açıklama
get_bookings	İsteğe bağlı filtrelerle rezervasyonları listeler
get_booking	UID'ye göre belirli bir rezervasyonu alır
create_booking	Yeni bir rezervasyon oluşturur
reschedule_booking	Bir rezervasyonu yeniden planlar
cancel_booking	Bir rezervasyonu iptal eder
confirm_booking	Bekleyen bir rezervasyonu onaylar
mark_booking_absent	Bir rezervasyon devamsızlığını işaretler
get_booking_attendees	Bir rezervasyon için tüm katılımcıları alır
add_booking_attendee	Bir rezervasyona katılımcı ekler
get_booking_attendee	Belirli bir katılımcıyı alır
get_booking_routing_trace	Bir rezervasyon için yönlendirme izini alır
get_org_team_bookings	Bir organizasyon ekibi için rezervasyonları alır
get_org_user_bookings	Bir organizasyon kullanıcısı için rezervasyonları alır

Programlar

Araç	Açıklama
get_schedules	Tüm programları listeler
get_schedule	Kimliğe göre belirli bir programı alır
create_schedule	Yeni bir program oluşturur
update_schedule	Bir programı günceller
delete_schedule	Bir programı siler
get_default_schedule	Varsayılan programınızı alır

Uygunluk ve takvimler

Araç	Açıklama
get_availability	Uygun zaman aralıklarını alır
get_busy_times	Takvimlerden meşgul zamanları alır
get_connected_calendars	Bağlı takvimleri listeler
get_conferencing_apps	Konferans uygulamalarını listeler

Ekipler ve üyelikler

Araç	Açıklama
get_my_teams	Üyesi olduğunuz ekipleri alır
get_org_teams	Organizasyon ekiplerini alır
create_team_invite	Birini bir ekibe davet eder
create_team_membership	Bir ekip üyeliği oluşturur
get_team_memberships	Tüm ekip üyeliklerini alır
get_team_membership	Bir ekip üyeliğini alır
update_team_membership	Bir ekip üyeliğini günceller
delete_team_membership	Bir ekip üyeliğini siler

Organizasyonlar

Araç	Açıklama
get_org_memberships	Tüm organizasyon üyeliklerini alır
create_org_membership	Bir organizasyon üyeliği oluşturur
get_org_membership	Bir organizasyon üyeliğini alır
update_org_membership	Bir organizasyon üyeliğini günceller
delete_org_membership	Bir organizasyon üyeliğini siler
get_org_attributes	Organizasyon özniteliklerini alır
get_org_attribute	Bir organizasyon özniteliğini alır
get_attribute_options	Bir öznitelik için seçenekleri alır
get_user_attributes	Bir kullanıcıya atanmış öznitelikleri alır
assign_attribute_to_user	Bir kullanıcıya öznitelik atar
update_user_attribute	Bir kullanıcıya atanmış özniteliği günceller
unassign_attribute_from_user	Bir kullanıcıdan özniteliği kaldırır
get_user_attribute_history	Bir kullanıcının öznitelik atama geçmişini alır

Yönlendirme formları

Araç	Açıklama
calculate_routing_form_slots	Yönlendirme formu yanıtına göre aralıkları hesaplar
get_org_routing_forms	Organizasyon yönlendirme formlarını alır
get_org_routing_form_responses	Yönlendirme formu yanıtlarını alır

API kataloğu

Araç	Açıklama
find_api_operation	Tam API v2 işlem kataloğunda arama yapar
describe_api_operation	Bir API işlemi için giriş şemasını alır
call_api_operation	Katalogdan herhangi bir API v2 işlemini yürütür

Örnek komutlar

Bağlandıktan sonra Cal.com ile doğal dil kullanarak 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 toplantımı iptal et"
• "Gelecek Pazartesi için uygun aralıklarımı göster"
• "Saat 14:00 toplantımı Perşembe 15:00'e yeniden planla"
• "Hangi etkinlik türlerine sahibim?"

İlgili kaynaklar

• AI ajanları rehberi — Cal.com API'sini doğrudan kullanarak AI ajanları oluşturun
• API v2 referansı — tam API uç noktası dokümantasyonu
• GitHub deposu — kaynak kod

Bu dokümantasyon, bir geliştirici dokümantasyon platformu olan Mintlify üzerinde oluşturulmuş ve barındırılmıştır.