Cal.com über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Cal.com klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Cal.com + Gemini

Lies ein Cal.com-Terminkonto aus Claude, ChatGPT oder Copilot: Event-Typen, Buchungen mit Teilnehmern, Cal-Video-Aufzeichnungen und Transkripte, freie Zeitfenster, Verfügbarkeitspläne und verbundene Kalender. Buchen, Verschieben und Absagen sind enthalten, aber bei der Installation deaktiviert.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

CALCOM_API_HOST, CALCOM_API_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten. Du brauchst ein Cal.com-Konto (jeder Tarif), um einen persönlichen API-Schlüssel anzulegen. Der Schlüssel handelt als der Nutzer, der ihn erstellt hat.

1. Melde dich bei Cal.com an und öffne Settings → Developer → API Keys (auf app.cal.com, oder auf app.cal.eu, wenn dein Konto in der EU-Region von Cal.com liegt).
2. Klicke auf New, gib dem Schlüssel einen Namen (zum Beispiel AnythingMCP) und ein Ablaufdatum und kopiere ihn. Er beginnt mit cal_live_ (oder cal_test_ im Testmodus) und wird nur einmal angezeigt.
3. Füge nur den Schlüssel, ohne das Wort Bearer, in CALCOM_API_KEY ein.
4. Setze CALCOM_API_HOST auf https://api.cal.com, wenn du dich auf app.cal.com anmeldest, oder auf https://api.cal.eu, wenn du dich auf app.cal.eu anmeldest. Trag den Host ohne /v2, Pfad oder Schrägstrich am Ende ein: Den Teil /v2 ergänzt der Connector selbst. Ein Schlüssel funktioniert nur in seiner eigenen Region.
5. Installiere den Connector und rufe calcom_get_me auf: Es zeigt den Nutzer, zu dem der Schlüssel gehört, mit Zeitzone und Standardplan, und bestätigt, dass Schlüssel und Host zusammenpassen.

Wessen Daten sie sieht: die Event-Typen, Buchungen und Verfügbarkeitspläne des Schlüsselinhabers, dazu Team-Buchungen, bei denen dieser Nutzer Host oder Admin ist. Alle, die den Connector nutzen, arbeiten mit diesem einen Konto. Nimm also den Schlüssel der Person (oder des Team-Admins), deren Termine die KI sehen soll.

Was sie liest: deine Event-Typen (die buchbaren Terminvorlagen) mit Dauer, Orten, Buchungsfeldern, Pufferzeiten, Mindestvorlauf und Buchungslink; Buchungen mit Status, Zeiten, Meeting-Link, Hosts, Teilnehmern mit E-Mail und Zeitzone, Gästen und den Antworten auf Buchungsfragen; die Cal-Video-Aufzeichnungen und Transkripte einer Buchung; die freien Zeitfenster eines Event-Typs; deine Verfügbarkeitspläne mit Wochenzeiten und Ausnahmen an einzelnen Tagen; und die verbundenen Kalender (Google, Outlook, Apple, CalDAV), einschließlich der Kalender, die auf Konflikte geprüft werden, und des Kalenders, in den neue Buchungen eingetragen werden.

Buchungs-uid statt ID: Buchungstools brauchen die uid der Buchung, eine Zeichenkette, die die KI aus calcom_list_bookings holt, nicht die numerische ID. Die uid einer wiederkehrenden Buchung liefert alle Termine der Serie. Buchungen lassen sich nach Status (upcoming, past, cancelled, unconfirmed), Teilnehmer, Event-Typ, Team oder Zeitraum filtern und kommen seitenweise.

Zeitzonen: Freie Zeitfenster kommen in der Zeitzone zurück, in der du denkst und die die KI an calcom_get_available_slots übergibt. Startzeiten von Buchungen gehen dagegen in UTC an Cal.com. Deine Kalender, Pufferzeiten, der Mindestvorlauf und Limits sind in den Zeitfenstern schon berücksichtigt.

Aufzeichnungen und Transkripte: Die gibt es nur bei Cal-Video-Meetings, und nur der Organisator, ein Team-Admin oder ein Organisations-Admin kann sie lesen. Meetings über Zoom, Google Meet oder Teams haben hier keine. Ein Transkript entsteht, wenn jemand im Gespräch auf Transcribe geklickt hat, und sein Download-Link gilt eine Stunde. Die KI holt bei Bedarf einen neuen.

Bei der Installation deaktiviert: calcom_create_booking, calcom_reschedule_booking und calcom_cancel_booking. Sie schicken echten Teilnehmern E-Mails und ändern echte Kalender: Eine neue Buchung verschickt Bestätigungen und Einladungen (bei kostenpflichtigen Event-Typen kann der Teilnehmer zur Zahlung aufgefordert werden), Verschieben sagt die alte Buchung ab und legt eine neue mit neuer uid an, und eine Absage lässt sich nicht rückgängig machen (bei einer wiederkehrenden Buchung betrifft sie alle Termine). Ein Administrator kann sie einzeln einschalten.

Fragt vor jeder Änderung: Ist ein Schreibtool eingeschaltet, prüft die KI zuerst die Zeit mit calcom_get_available_slots, zeigt dir dann Event-Typ, Uhrzeit in deiner Zeitzone, Teilnehmer und Gäste oder den Grund und wartet auf dein Ja.

Limits: Cal.com erlaubt etwa 120 Anfragen pro Minute und API-Schlüssel. Nach einem 429 wartet die KI eine Minute, bevor sie es erneut versucht.

Häufige Fehler: 401 Invalid API Key bedeutet, dass der Schlüssel falsch, abgelaufen oder gelöscht ist oder zur anderen Region gehört. 403 heißt, der Schlüssel funktioniert, aber dieser Nutzer sieht die Buchung, den Event-Typ oder das Team nicht: Nimm den Schlüssel des Organisators oder eines Team-Admins. 404 bedeutet meist, dass eine numerische ID statt einer Buchungs-uid verwendet wurde. Bei 400 nennt Cal.com das Feld, das es nicht akzeptiert hat, oft eine Startzeit, die kein freies Zeitfenster ist.

Der Connector ändert keine Event-Typen, Verfügbarkeitspläne oder verbundenen Kalender und nimmt weder Zahlungen entgegen noch erstattet er sie.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Cal.com-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche Termine habe ich morgen, und wer nimmt jeweils teil?“
• „Such mir nächste Woche drei freie Zeitfenster für meinen Event-Typ Kennenlerngespräch, in deutscher Zeit, damit ich sie einem Kunden anbieten kann.“
• „Hol das Transkript des gestrigen Calls mit Müller GmbH und liste die vereinbarten nächsten Schritte auf.“
• „Welche Buchungen wurden diesen Monat abgesagt oder verschoben, und welche Gründe wurden angegeben?“
• „Wie sehen meine Arbeitszeiten im Standardplan aus, und welche Kalender prüft Cal.com auf Konflikte?“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden