Mit Cursor verbinden

In Cursor bindest du Kalender Sync als Remote-MCP-Server ein. Danach kennt der Agent in Cursor deine Kalender über alle verbundenen Anbieter — Google, Outlook, iCloud, GMX, WEB.DE und mehr.

1. Zugang und Schlüssel in Kalender Sync erstellen

Noch kein Konto? Lege es unter app.kalender-sync.de an (7 Tage Professional gratis, keine Kreditkarte) und verbinde deine Kalender.

Öffne in der App KI-Assistent → Assistent verbinden und wähle Etwas anderes. Wie bei jedem Zugang wählst du die Kalender einzeln aus und stellst je Kalender die Detailtiefe ein — nicht freigegebene Kalender existieren für Cursor nicht.

Mit Schlüssel erstellen bekommst du deinen Zugriffs-Schlüssel (ein Token, beginnt mit ksa_). Er wird nur einmal angezeigt. Behandle ihn wie ein Passwort: Wer den Schlüssel hat, hat genau den Zugriff, den du diesem Zugang gegeben hast. Füge ihn nie in einen Chat ein.

Warum ein Schlüssel und kein Anmeldefenster?

Die Anmeldung per Browser-Fenster (OAuth) bieten wir derzeit nur für Claude und ChatGPT an. Cursor verbindet sich deshalb mit einem Zugriffs-Schlüssel. Für dich ändert das nichts an den Rechten: Du bestimmst weiterhin je Kalender, was sichtbar ist und ob Termine angelegt werden dürfen.

2. Kalender Sync in Cursor eintragen

1. Lege den Schlüssel als Umgebungsvariable KALENDER_SYNC_KEY in deinem Shell-Profil oder Systemumfeld ab (Cursor liest bei Remote-Servern keine envFile). Alternativ trägst du ihn direkt statt ${env:KALENDER_SYNC_KEY} ein — dann gehört die Datei nicht in ein Git-Repository.
2. Ergänze in ~/.cursor/mcp.json (für alle Projekte) oder .cursor/mcp.json (nur dieses Projekt) den Eintrag. Bestehende Server bleiben erhalten:

{
  "mcpServers": {
    "kalender-sync": {
      "url": "https://app.kalender-sync.de/mcp",
      "headers": {
        "Authorization": "Bearer ${env:KALENDER_SYNC_KEY}"
      }
    }
  }
}

3. Cursor neu laden. Unter Settings → MCP sollte kalender-sync mit seinen Tools erscheinen.

Danach kannst du loslegen, z. B.: „Welche Kalender sind über Kalender Sync freigegeben?”, „Wo habe ich diese Woche zwei Stunden am Stück?” oder „Wann ist mein Zahnarzt-Termin?”

Wenn etwas nicht klappt

• 401 / „Unauthorized“: Schlüssel falsch, abgelaufen oder widerrufen. Prüfe den Header: Name exakt Authorization, Wert Bearer ksa_… (mit Leerzeichen). Im Zweifel einen neuen Schlüssel erstellen.
• Ein Kalender fehlt: Er ist für diesen Zugang nicht freigegeben. Ergänze ihn in der App unter KI-Assistent → Freigabe bearbeiten — das wirkt sofort, ein neuer Schlüssel ist nicht nötig.

Zugang widerrufen

In Kalender Sync unter KI-Assistent beim Zugang auf Widerrufen — sofort wirksam, der Schlüssel ist damit ungültig, egal was in Cursor gespeichert ist. Mehr dazu unter Zugang widerrufen.