Mit Claude, ChatGPT und Cursor planen: der WhenToMeet-MCP-Server

Wir haben keinen KI-Assistenten in WhenToMeet ausgeliefert. Du hast schon einen.

Wenn du Claude, ChatGPT oder Cursor nutzt, ist der Assistent, für den du bezahlst, nützlicher als jeder Chatbot, den wir in eine Seitenleiste quetschen könnten. Was ihm fehlt, ist die Erlaubnis, deinen Kalender anzufassen. Genau das gibt ihm der MCP-Server.

Ein Satz zu MCP

MCP – das Model Context Protocol – ist eine kleine Spezifikation, um einem LLM-Client Tools zur Verfügung zu stellen. Der Client verbindet sich mit einem Server, liest eine Liste typisierter Tools und ruft sie auf, wenn die Konversation eines braucht. Es ist der Stecker, nicht die Lampe. WhenToMeet betreibt den Server; dein Assistent deiner Wahl ist der Client.

Der Endpoint ist POST /api/mcp. Stateless HTTP-Transport. Gleiche API-Keys wie bei REST v1.

Installation

Im MCP-Client – Claude Desktop, ChatGPT mit Connectors, Cursor oder einem anderen – fügst du einen Server-Eintrag hinzu, der auf https://whentomeet.com/api/mcp zeigt, mit deinem API-Key als Bearer-Token. Die genaue Config-Form unterscheidet sich pro Client; docs.whentomeet.io hat die Copy-paste-Snippets für die üblichen.

Sobald die Verbindung steht, sieht der Assistent sieben Tools:

• list_polls – deine Scheduling Polls und Direct Events
• get_poll – ein Event mit seinen Slots und Teilnehmerstimmen
• create_poll – ein neues Scheduling Event anlegen
• list_bookings – Termine, die über deine Booking Pages gebucht wurden
• list_calendar_events – ein vereinheitlichter Feed über alle verbundenen Kalender
• check_conflicts – kollidiert dieser Zeitraum mit irgendetwas
• get_user_profile – dein Tier, deine Zeitzone, deine Einstellungen

Das ist die komplette Oberfläche heute.

Prompts, die tatsächlich funktionieren

Generische Prompts erzeugen generische Calls. Das hier funktioniert:

„Was steht nächsten Dienstag zwischen 10 und 16 Uhr in meinem Kalender? Nutze list_calendar_events mit dem Zeitraum."

„Ich will morgen vormittag einen zweistündigen Fokus-Block. Prüf meinen Kalender mit check_conflicts und schlag drei freie Startzeiten vor."

„Leg eine Scheduling-Poll namens ‚Q3 Planung' an mit sechs einstündigen Slots zwischen 2026-05-04 und 2026-05-06, nur Arbeitszeiten."

„Fass meine Bookings der letzten 30 Tage zusammen – wer hat was gebucht, und wie viele No-Shows."

„Entwirf eine Agenda für das morgige Standup basierend darauf, was diese Woche in meinem Kalender steht."

Das Muster: Nenne das Tool, wenn du die Kontrolle willst, beschreibe das Ergebnis, wenn nicht. Claude und GPT sind beide gut darin, aus der Beschreibung das richtige Tool zu wählen.

Was es heute noch nicht kann

Die MCP-Oberfläche ist nicht das ganze Produkt. Zum Zeitpunkt dieses Textes kann der Assistent nicht:

• Für dich auf der Poll einer anderen Person abstimmen
• Ein bestehendes Event bearbeiten oder absagen
• Booking-Page-Einstellungen lesen oder ändern
• Etwas tun, das OAuth in einen fremden Kalender an deiner Stelle erfordert – das passiert einmal in unserer UI, und danach sieht der MCP-Server die vereinheitlichten Daten

Das sind Lücken, die wir schließen, je nachdem, was Leute tatsächlich anfragen. Wenn das Tool, das du willst, nicht da ist, sag uns Bescheid.

Rate-Limits und Keys

Der MCP-Server nutzt die gleichen Keys wie REST v1 und die gleichen Per-Key-Limits. Normale konversationelle Nutzung – ein Dutzend Tool-Calls pro Session – ist weit unter der Obergrenze. Wenn du einen Batch-Job fährst, nimm direkt die REST-Endpoints; dafür sind sie da.

API-Zugriff ist Pro-gated. Erzeuge in den Einstellungen einen Key, leg ihn in die Config deines MCP-Clients, fertig.

Warum wir es so gemacht haben

Wir hätten ein Chat-Panel in die App bauen können. Das wäre demo-freundlich gewesen. Aber der Assistent, den du schon nutzt, ist besser, ist schon in deinem Workflow, und hat Kontext, den wir nie haben werden. Ihm eine saubere Oberfläche auf deinem Kalender zu geben, ist mehr wert, als dir eine schlechtere Version von Claude innerhalb von WhenToMeet zu geben.

Komplette Setup-Docs und die aktuelle Tool-Referenz leben auf docs.whentomeet.io.