Cal.com MCP

MCP-Server

Verbinden Sie KI-Clients über das Model Context Protocol mit der Cal.com-Terminplanung, indem Sie den gehosteten Server unter mcp.cal.com oder eine lokale Instanz nutzen.

Der Cal.com MCP-Server verpackt die Cal.com API v2 in das Model Context Protocol und ermöglicht Ihnen so die Verwaltung von Buchungen, Ereignistypen, Zeitplänen und mehr in natürlicher Sprache in jedem MCP-kompatiblen Client.

Gehosteter Server (mcp.cal.com)

Der schnellste Einstieg ist die direkte Verbindung Ihres MCP-Clients mit mcp.cal.com. Der gehostete Server verwendet Streamable HTTP-Transport mit OAuth 2.1-Authentifizierung – Ihr Client führt den Autorisierungsablauf automatisch durch.

Ihren Client verbinden

Richten Sie Ihren MCP-Client auf die URL des gehosteten Servers:

https://mcp.cal.com/mcp

Bei der ersten Verbindung führt Ihr Client Sie durch einen OAuth-Autorisierungsablauf, bei dem Sie dem Server Zugriff auf Ihr Cal.com-Konto gewähren. Ein API-Schlüssel ist nicht erforderlich.

Fügen Sie Folgendes zu Ihrer `claude_desktop_config.json` hinzu:

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

Öffnen Sie **Einstellungen → MCP** und fügen Sie einen neuen Server mit der URL `https://mcp.cal.com/mcp` hinzu, oder fügen Sie ihn zu Ihrer `.cursor/mcp.json` hinzu:

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

Fügen Sie den Server zu Ihren VS Code MCP-Einstellungen hinzu:

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

Selbst gehosteter Server (stdio)

Wenn Sie den Server lieber lokal ausführen möchten, können Sie den stdio-Transport mit einem API-Schlüssel verwenden. Dies ist nützlich für die Entwicklung oder wenn Sie die volle Kontrolle über den Server haben möchten.

Voraussetzungen

• Node.js >= 18
• Ein Cal.com API-Schlüssel – generieren Sie einen unter Einstellungen → Entwickler → API-Schlüssel

Ihren Client verbinden

Fügen Sie Folgendes zur Konfiguration Ihres MCP-Clients hinzu:

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

Ersetzen Sie cal_live_xxxx durch Ihren tatsächlichen API-Schlüssel.

Geben Sie Ihren API-Schlüssel niemals weiter und committen Sie ihn nicht. Falls er offengelegt wurde, rotieren Sie ihn sofort in Ihren [Cal.com-Einstellungen](https://app.cal.com/settings/developer/api-keys).

Verfügbare Werkzeuge

Der MCP-Server stellt 34 Werkzeuge bereit, die nach Kategorien geordnet sind:

Benutzerprofil

Werkzeug	Beschreibung
get_me	Ihr authentifiziertes Benutzerprofil abrufen
update_me	Ihr Benutzerprofil aktualisieren

Ereignistypen

Werkzeug	Beschreibung
get_event_types	Alle Ereignistypen auflisten
get_event_type	Einen bestimmten Ereignistyp anhand der ID abrufen
create_event_type	Einen neuen Ereignistyp erstellen
update_event_type	Einen Ereignistyp aktualisieren
delete_event_type	Einen Ereignistyp löschen

Buchungen

Werkzeug	Beschreibung
get_bookings	Buchungen mit optionalen Filtern auflisten
get_booking	Eine bestimmte Buchung anhand der UID abrufen
create_booking	Eine neue Buchung erstellen
reschedule_booking	Eine Buchung umbuchen
cancel_booking	Eine Buchung stornieren
confirm_booking	Eine ausstehende Buchung bestätigen
mark_booking_absent	Eine Abwesenheit für eine Buchung markieren
get_booking_attendees	Alle Teilnehmer einer Buchung abrufen
add_booking_attendee	Einen Teilnehmer zu einer Buchung hinzufügen
get_booking_attendee	Einen bestimmten Teilnehmer abrufen

Zeitpläne

Werkzeug	Beschreibung
get_schedules	Alle Zeitpläne auflisten
get_schedule	Einen bestimmten Zeitplan anhand der ID abrufen
create_schedule	Einen neuen Zeitplan erstellen
update_schedule	Einen Zeitplan aktualisieren
delete_schedule	Einen Zeitplan löschen
get_default_schedule	Ihren Standardzeitplan abrufen

Verfügbarkeit

Werkzeug	Beschreibung
get_availability	Verfügbare Zeitfenster abrufen
get_busy_times	Belegte Zeiten aus Kalendern abrufen

Konferenzen

Werkzeug	Beschreibung
get_conferencing_apps	Konferenzanwendungen auflisten

Routing-Formulare

Werkzeug	Beschreibung
calculate_routing_form_slots	Zeitfenster basierend auf der Antwort des Routing-Formulars berechnen

Organisationen

Werkzeug	Beschreibung
get_org_memberships	Alle Organisationsmitgliedschaften abrufen
create_org_membership	Eine Organisationsmitgliedschaft erstellen
get_org_membership	Eine Organisationsmitgliedschaft abrufen
delete_org_membership	Eine Organisationsmitgliedschaft löschen
get_org_routing_forms	Routing-Formulare der Organisation abrufen
get_org_routing_form_responses	Antworten auf Routing-Formulare abrufen

Beispiel-Prompts

Sobald die Verbindung hergestellt ist, können Sie mit Cal.com in natürlicher Sprache interagieren:

• "Welche Buchungen habe ich diese Woche?"
• "Erstelle einen 30-minütigen Ereignistyp namens 'Quick Chat'"
• "Storniere mein Meeting mit John morgen"
• "Zeige mir meine verfügbaren Zeitfenster für nächsten Montag"
• "Buche mein 14-Uhr-Meeting auf Donnerstag 15 Uhr um"
• "Welche Ereignistypen habe ich?"

Verwandte Ressourcen

• Leitfaden für KI-Agenten – Erstellen Sie KI-Agenten mit der Cal.com API direkt
• API v2-Referenz – vollständige Dokumentation der API-Endpunkte
• GitHub-Repository – Quellcode