calcom-mcp

Cal.com FastMCP Server

⚠️ Haftungsausschluss : Dieses Projekt steht in keiner Verbindung zu Cal.com und wird auch nicht von Cal.com unterstützt. Ich bin ein unabhängiger Entwickler und stehe in keiner offiziellen Verbindung zu Cal.com.

Dieses Projekt bietet einen FastMCP-Server für die Interaktion mit der Cal.com-API. Es ermöglicht Sprachlernmodellen (LLMs) die Nutzung von Tools zur Anbindung wichtiger Cal.com-Funktionen wie der Verwaltung von Veranstaltungstypen und Buchungen.

Voraussetzungen

• Python 3.8+
• Ein Cal.com-Konto und ein API-Schlüssel (v2)

Aufstellen

1. Klonen Sie das Repository (falls zutreffend) oder laden Sie die Dateien herunter.
   git clone https://github.com/Danielpeter-99/calcom-mcp.git cd calcom-mcp
2. Erstellen Sie eine virtuelle Umgebung (empfohlen):
   python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
3. Installieren Sie Abhängigkeiten:
   pip install -r requirements.txt
4. Richten Sie den Cal.com API-Schlüssel ein: Sie müssen die Umgebungsvariable CALCOM_API_KEY festlegen. Sie finden Ihren API-Schlüssel auf Ihrer Cal.com-Einstellungsseite (normalerweise unter „Entwicklereinstellungen“ oder „Sicherheitseinstellungen“).
   • Linux/macOS:
     export CALCOM_API_KEY="your_actual_api_key_here"
     Um es dauerhaft zu machen, fügen Sie diese Zeile zu Ihrer Shell-Konfigurationsdatei hinzu (z. B. .bashrc , .zshrc ).
   • Windows (PowerShell):
     $env:CALCOM_API_KEY="your_actual_api_key_here"
     Um es dauerhaft zu machen, können Sie es über Systemeigenschaften > Umgebungsvariablen festlegen.

Ausführen des Servers

Sobald die Einrichtung abgeschlossen ist, können Sie den FastMCP-Server ausführen:

Der Server startet unter localhost:8010. Sie sollten eine Ausgabe sehen, die den Betrieb anzeigt. Wenn der CALCOM_API_KEY nicht gesetzt ist, wird eine Warnung angezeigt.

Verfügbare Tools

Der Server stellt derzeit die folgenden Tools für die LLM-Interaktion bereit:

• get_api_status() : Überprüft, ob der Cal.com-API-Schlüssel in der Umgebung konfiguriert ist. Gibt eine Zeichenfolge zurück, die den Status angibt.
• list_event_types() : Ruft eine Liste aller Ereignistypen von Cal.com für das authentifizierte Konto ab. Gibt ein Wörterbuch mit der Liste der Ereignistypen oder einer Fehlermeldung zurück.
• get_bookings(...) : Ruft eine Liste der Buchungen von Cal.com ab, mit optionalen Filtern (event_type_id, user_id, status, date_from, date_to, limit). Gibt ein Wörterbuch mit der Buchungsliste oder einer Fehlermeldung zurück.
• create_booking(...) : Erstellt eine neue Buchung in Cal.com für einen bestimmten Veranstaltungstyp und Teilnehmer. Erfordert Parameter wie Startzeit, Teilnehmerdaten und Veranstaltungstypkennungen. Gibt ein Wörterbuch mit Buchungsdetails oder eine Fehlermeldung zurück.
• list_schedules(...) : Listet alle für den authentifizierten Benutzer oder einen bestimmten Benutzer/ein bestimmtes Team verfügbaren Zeitpläne auf. Optionale Filter: Benutzer-ID, Team-ID, Limit. Gibt ein Wörterbuch mit der Liste der Zeitpläne oder einer Fehlermeldung zurück.
• list_teams(...) : Listet alle für den authentifizierten Benutzer verfügbaren Teams auf. Optionaler Filter: limit. Gibt ein Wörterbuch mit der Liste der Teams oder eine Fehlermeldung zurück.
• list_users(...) : Listet alle Benutzer auf, die für das authentifizierte Konto verfügbar sind. Optionaler Filter: limit. Gibt ein Wörterbuch mit der Benutzerliste oder einer Fehlermeldung zurück.
• list_webhooks(...) : Listet alle für das authentifizierte Konto konfigurierten Webhooks auf. Optionaler Filter: limit. Gibt ein Wörterbuch mit der Liste der Webhooks oder einer Fehlermeldung zurück.

Hinweis: Für alle Tools muss die Umgebungsvariable CALCOM_API_KEY festgelegt sein. Andernfalls geben die Tools eine strukturierte Fehlermeldung zurück.

Toolnutzung und Fehlerbehandlung

• Alle Tools geben entweder die API-Antwort (als Wörterbuch oder Zeichenfolge) oder eine strukturierte Fehlermeldung mit Details zum Fehler zurück.
• Fehlermeldungen umfassen die Art des Fehlers, den HTTP-Statuscode (falls zutreffend) und den Antworttext der Cal.com-API.
• Um optimale Ergebnisse zu erzielen, überprüfen Sie immer, ob in der Antwort ein error vorhanden ist, bevor Sie die zurückgegebenen Daten verwenden.
• Die Tools sind robust konzipiert und bieten informatives Feedback zu erfolgreichen und fehlgeschlagenen API-Aufrufen.

Entwicklungsnotizen

• Die Basis-URL der Cal.com-API ist auf https://api.cal.com/v2 eingestellt.
• Die Authentifizierung erfolgt primär über ein Bearer-Token mit dem CALCOM_API_KEY .
• Das Tool create_booking verwendet den Header cal-api-version: 2024-08-13 , wie in der Cal.com API v2-Dokumentation für diesen Endpunkt angegeben.
• Um informative Antworten bereitzustellen, ist in den API-Aufrufen eine Fehlerbehandlung enthalten.

🚀 Gebaut mit

Wichtiger Sicherheitshinweis

Coden Sie Ihren CALCOM_API_KEY niemals direkt in den Quellcode ein. Verwenden Sie stets Umgebungsvariablen, wie in der Einrichtungsanleitung beschrieben, um Ihren API-Schlüssel zu schützen.