Cal.com MCP

offiziell

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

Auf cal.com ansehenDieses MCP ausprobierenGesponsert

Was kann man mit Cal Com MCP machen?

Buchungen verwalten — Bitten Sie Ihren Assistenten, Buchungen aufzulisten, zu erstellen, zu verschieben oder zu stornieren, indem Sie Tools wie get_bookings und create_booking verwenden.
Eventtypen konfigurieren — Erstellen oder aktualisieren Sie Eventtypen, z. B. einen 30-minütigen „Quick Chat“, über create_event_type und update_event_type.
Verfügbarkeit prüfen — Fragen Sie offene Zeitfenster oder belegte Zeiträume aus verbundenen Kalendern mit get_availability und get_busy_times ab.
Zeitpläne verwalten — Erstellen, aktualisieren oder rufen Sie Ihren Standardzeitplan mit create_schedule und get_default_schedule ab.
Teams und Mitgliedschaften verwalten — Laden Sie Mitglieder ein oder passen Sie Teamrollen über create_team_invite und update_team_membership an.

Dokumentation

MCP-Server

Verbinden Sie KI-Clients mit der Cal.com-Terminplanung über das Model Context Protocol, entweder mit dem gehosteten Server unter mcp.cal.com oder einer lokalen Instanz.

Der Cal.com MCP-Server kapselt die Cal.com API v2 im Model Context Protocol und ermöglicht Ihnen die Verwaltung von Buchungen, Eventtypen, Zeitplänen und mehr über natürliche Sprache in jedem MCP-kompatiblen Client.

Gehosteter Server (mcp.cal.com)

Der schnellste Weg, loszulegen, ist, Ihren MCP-Client direkt mit mcp.cal.com zu verbinden. Der gehostete Server verwendet Streamable-HTTP-Transport mit OAuth-2.1-Authentifizierung – Ihr Client übernimmt den Autorisierungsablauf automatisch.

Client verbinden

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

https://mcp.cal.com/mcp

Beim ersten Verbinden führt Sie Ihr Client durch einen OAuth-Autorisierungsablauf, bei dem Sie dem Server Zugriff auf Ihr Cal.com-Konto gewähren. Es ist kein API-Schlüssel 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"
    }
  }
}
```

Fügen Sie Folgendes zu Ihrer `~/.fx/mcp.json` hinzu:

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

Führen Sie dann `/mcp auth calcom --open` in fx aus, um zu autorisieren. Siehe die
[fx-MCP-Dokumentation](https://fx.sh/docs/capabilities/mcp) für Transporte,
Authentifizierungsoptionen und Tool-Erkennung.

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 wünschen.

Voraussetzungen

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

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.

Warnung

Geben Sie Ihren API-Schlüssel niemals weiter und committen Sie ihn nicht. Wenn er offengelegt wurde, rotieren Sie ihn sofort in Ihren Cal.com-Einstellungen.

Toolsets

Sie können einschränken, welche Tools der Server für eine Sitzung registriert, indem Sie einen toolsets-Abfrageparameter an die Server-URL anhängen:

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

Gültige Toolsets: profile, event-types, bookings, availability, schedules, calendars, teams, organizations, routing-forms, catalog (die find_api_operation / describe_api_operation / call_api_operation-Meta-Tools). Unbekannte Namen werden mit 400 invalid_request abgelehnt. Wenn der Parameter weggelassen wird, werden alle Tools registriert; die lokalen Tools get_app_link und search_docs werden unabhängig von der Auswahl immer registriert. Für einen selbst gehosteten stdio-Server setzen Sie stattdessen MCP_TOOLSETS.

Verfügbare Tools

Der MCP-Server stellt 63 Tools bereit, die nach Kategorie organisiert sind:

App-Links

Tool	Beschreibung
`get_app_link`	Erstellt eine URL, die eine Buchung, einen Eventtyp, einen Zeitplan, ein Team, ein Routing-Formular oder eine Einstellungsseite in der Cal.com-Web-App öffnet

Dokumentation

Tool	Beschreibung
`search_docs`	Durchsucht die Cal.com-Produktdokumentation; gibt bewertete Seiten mit einem Auszug des besten Ergebnisses zurück

Benutzerprofil

Tool	Beschreibung
`get_me`	Ruft Ihr authentifiziertes Benutzerprofil ab
`update_me`	Aktualisiert Ihr Benutzerprofil

Eventtypen

Tool	Beschreibung
`get_event_types`	Listet alle Eventtypen auf
`get_event_type`	Ruft einen bestimmten Eventtyp anhand der ID ab
`create_event_type`	Erstellt einen neuen Eventtyp
`update_event_type`	Aktualisiert einen Eventtyp
`delete_event_type`	Löscht einen Eventtyp
`get_event_type_settings`	Ruft die Einstellungen eines Eventtyps ab
`get_event_type_history`	Ruft den Änderungsverlauf eines Eventtyps ab
`get_scheduling_config`	Ruft die Terminplanungskonfiguration eines Eventtyps ab
`get_crm_sync_errors`	Ruft CRM-Synchronisierungsfehler für einen Eventtyp ab

Buchungen

Tool	Beschreibung
`get_bookings`	Listet Buchungen mit optionalen Filtern auf
`get_booking`	Ruft eine bestimmte Buchung anhand der UID ab
`create_booking`	Erstellt eine neue Buchung
`reschedule_booking`	Verschiebt eine Buchung
`cancel_booking`	Storniert eine Buchung
`confirm_booking`	Bestätigt eine ausstehende Buchung
`mark_booking_absent`	Markiert eine Buchung als abwesend
`get_booking_attendees`	Ruft alle Teilnehmer einer Buchung ab
`add_booking_attendee`	Fügt einer Buchung einen Teilnehmer hinzu
`get_booking_attendee`	Ruft einen bestimmten Teilnehmer ab
`get_booking_routing_trace`	Ruft die Routing-Ablaufverfolgung für eine Buchung ab
`get_org_team_bookings`	Ruft Buchungen für ein Organisationsteam ab
`get_org_user_bookings`	Ruft Buchungen für einen Organisationsbenutzer ab

Zeitpläne

Tool	Beschreibung
`get_schedules`	Listet alle Zeitpläne auf
`get_schedule`	Ruft einen bestimmten Zeitplan anhand der ID ab
`create_schedule`	Erstellt einen neuen Zeitplan
`update_schedule`	Aktualisiert einen Zeitplan
`delete_schedule`	Löscht einen Zeitplan
`get_default_schedule`	Ruft Ihren Standardzeitplan ab

Verfügbarkeit & Kalender

Tool	Beschreibung
`get_availability`	Ruft verfügbare Zeitfenster ab
`get_busy_times`	Ruft belegte Zeiten aus Kalendern ab
`get_connected_calendars`	Listet verbundene Kalender auf
`get_conferencing_apps`	Listet Konferenzanwendungen auf

Teams & Mitgliedschaften

Tool	Beschreibung
`get_my_teams`	Ruft die Teams ab, denen Sie angehören
`get_org_teams`	Ruft Organisationsteams ab
`create_team_invite`	Lädt jemanden zu einem Team ein
`create_team_membership`	Erstellt eine Teammitgliedschaft
`get_team_memberships`	Ruft alle Teammitgliedschaften ab
`get_team_membership`	Ruft eine Teammitgliedschaft ab
`update_team_membership`	Aktualisiert eine Teammitgliedschaft
`delete_team_membership`	Löscht eine Teammitgliedschaft

Organisationen

Tool	Beschreibung
`get_org_memberships`	Ruft alle Organisationsmitgliedschaften ab
`create_org_membership`	Erstellt eine Organisationsmitgliedschaft
`get_org_membership`	Ruft eine Organisationsmitgliedschaft ab
`update_org_membership`	Aktualisiert eine Organisationsmitgliedschaft
`delete_org_membership`	Löscht eine Organisationsmitgliedschaft
`get_org_attributes`	Ruft Organisationsattribute ab
`get_org_attribute`	Ruft ein Organisationsattribut ab
`get_attribute_options`	Ruft Optionen für ein Attribut ab
`get_user_attributes`	Ruft einem Benutzer zugewiesene Attribute ab
`assign_attribute_to_user`	Weist einem Benutzer ein Attribut zu
`update_user_attribute`	Aktualisiert ein einem Benutzer zugewiesenes Attribut
`unassign_attribute_from_user`	Hebt die Zuweisung eines Attributs von einem Benutzer auf
`get_user_attribute_history`	Ruft den Verlauf der Attributzuweisungen eines Benutzers ab

Routing-Formulare

Tool	Beschreibung
`calculate_routing_form_slots`	Berechnet Zeitfenster basierend auf der Routing-Formularantwort
`get_org_routing_forms`	Ruft Organisations-Routing-Formulare ab
`get_org_routing_form_responses`	Ruft Routing-Formularantworten ab

API-Katalog

Tool	Beschreibung
`find_api_operation`	Durchsucht den vollständigen API-v2-Operationskatalog
`describe_api_operation`	Ruft das Eingabeschema für eine API-Operation ab
`call_api_operation`	Führt jede API-v2-Operation aus dem Katalog aus

Beispielaufforderungen

Nach der Verbindung können Sie mit Cal.com über natürliche Sprache interagieren:

„Welche Buchungen habe ich diese Woche?"
„Erstelle einen 30-minütigen Eventtyp namens ‚Quick Chat'"
„Storniere mein Meeting mit John morgen"
„Zeig mir meine verfügbaren Zeitfenster für nächsten Montag"
„Verschiebe mein Meeting um 14 Uhr auf Donnerstag um 15 Uhr"
„Welche Eventtypen habe ich?"

Zugehörige Ressourcen

KI-Agenten-Leitfaden – erstellen Sie KI-Agenten direkt mit der Cal.com-API
API-v2-Referenz – vollständige API-Endpunktdokumentation
GitHub-Repository – Quellcode

Diese Dokumentation wird auf Mintlify erstellt und gehostet, einer Plattform für Entwicklerdokumentation.