MCP

caldav-mcp: CalDAV-Kalender an den KI-Assistenten anbinden

Am besten geeignet für alle, die bereits ein CalDAV-Server-Konto haben und einen KI-Assistenten ihre Kalender anzeigen und verwalten lassen möchten. Server-URL, Benutzername und Passwort sind Pflicht; Erstellen, Aktualisieren und Löschen schreiben direkt in den Live-Kalender, daher vor jeder Aktion bestätigen.

Official source · caldav-mcp

Install

"command": "npx",
      "args": [
        "caldav-mcp"
      ],

Für wen ist das?

  • Für alle, die bereits ein CalDAV-Server-Konto haben (selbst gehostet oder von einem Anbieter) und einen KI-Assistenten ihre Kalender direkt anzeigen und verwalten lassen möchten. Die offizielle Verortung: Kalenderoperationen als Werkzeuge für KI-Assistenten bereitstellen.
  • Abgedeckte Operationen: Verbindung zu einem CalDAV-Server, Kalender auflisten, Kalendertermine eines Zeitraums auflisten, Termine erstellen, Termine aktualisieren, Termine per UID löschen.
  • Die Voraussetzungen sind klar: CalDAV-Server-URL, Benutzername und Passwort müssen über die drei Umgebungsvariablen CALDAV_BASE_URL, CALDAV_USERNAME und CALDAV_PASSWORD übergeben werden; alle drei sind Pflicht.
  • Nicht geeignet: für Nutzer ohne CalDAV-Server oder solche, die ihre Zugangsdaten nicht an einen lokalen Prozess übergeben wollen. Die offizielle Dokumentation sagt nicht, welche konkreten CalDAV-Server-Implementierungen unterstützt werden, und auch nicht, ob es einen Nur-Lese-Modus gibt; beides ist unbestätigt.

Erster Versuch in 3 Minuten

Empfohlener Hauptweg: Start über npx in der mcpServers-Konfiguration des MCP-Clients; npx lädt das caldav-mcp-Paket automatisch herunter und führt es aus. Fügen Sie diesen Ausschnitt in die Konfiguration ein:

"command": "npx",
      "args": [
        "caldav-mcp"
      ],

und stellen Sie die Zugangsdaten in derselben Konfiguration über Umgebungsvariablen bereit:

"CALDAV_BASE_URL": "<CalDAV server URL>",
        "CALDAV_USERNAME": "<CalDAV username>",
        "CALDAV_PASSWORD": "<CalDAV password>"

Nach dem Speichern und Neustart des Clients zunächst ein Leseaufruf: Bitten Sie den KI-Assistenten, „meine Kalender aufzulisten“ – das entspricht List calendars in der offiziellen Fähigkeitenliste. Das Erfolgssignal ist die Kalenderliste des Kontos. Dieser Schritt liest nur die Kalenderstruktur und erstellt oder ändert keine Termine, verbindet sich aber mit Ihren Zugangsdaten zum CalDAV-Server.

Wichtiger Hinweis: Erstellen, Aktualisieren und Löschen sind entfernte Schreibvorgänge, die den Live-Kalender direkt verändern. Lassen Sie den Assistenten vor jedem Schreibvorgang den geplanten Vorgang, den Zieltermin und die Felder wiedergeben, und führen Sie ihn erst nach Ihrer Bestätigung aus.

Das Projekt bietet zusätzlich eine Variante für die Entwicklung an: den TypeScript-Code direkt im Watch-Modus ausführen und Umgebungsvariablen automatisch aus .env laden; gedacht fürs Debuggen, im Alltag bleibt es beim npx-Hauptweg oben.

Anwendungsfälle

Fall 1: Verbindung und Berechtigungen prüfen (List calendars). Situation: Die Zugangsdaten sind frisch eingerichtet, URL oder Passwort sind unsicher. Vorgehen: Bitten Sie den Assistenten, „meine Kalender aufzulisten“ – der günstigste Lesevorgang zum Prüfen der Zugangsdaten. Erwartetes Ergebnis: die Kalenderliste dieses CalDAV-Kontos; schlägt es fehl, zuerst die drei Umgebungsvariablen prüfen und erneut versuchen.

Fall 2: Mit update-event nur die nötigen Felder ändern. Situation: Ein Termin verschiebt sich, Titel, Ort und alles andere bleiben gleich. Vorgehen: Den Assistenten den Zieltermin finden und update-event aufrufen lassen, dabei nur die zu ändernden Felder übergeben; die offizielle Beschreibung lautet: „Aktualisiert einen vorhandenen Kalendertermin. Nur die übergebenen Felder werden geändert.“. Erwartetes Ergebnis: Nur die übergebenen Felder werden aktualisiert, der Rest bleibt unverändert. Bestätigungspunkt: Das ist ein entfernter Schreibvorgang, der direkt auf dem CalDAV-Server landet – Zieltermin und zu ändernde Felder unbedingt vorab prüfen.

Grenzen

  • Lese-/Schreib-Charakter: Zu den Fähigkeiten gehören sowohl Lesen (Kalender auflisten, Termine eines Zeitraums auflisten) als auch Schreiben (Erstellen, Aktualisieren, Löschen per UID); die Werkzeuge wirken direkt auf den Live-Kalender. Gelöscht wird per UID; ob gelöschte Termine wiederherstellbar sind und ob es einen Rückgängig-Weg gibt, ist offiziell nicht beschrieben – im Bestätigungsschritt besonders streng sein.
  • Zugangsdaten: Server-URL, Benutzername und Passwort müssen über Umgebungsvariablen kommen; ob alternative Authentifizierung wie OAuth oder app-spezifische Passwörter unterstützt wird, ist nicht dokumentiert – unbestätigt.
  • Nebeneffekte und Bestätigungspunkte: Schreibvorgänge verändern den Kalender auf dem Server tatsächlich; update-event ändert nur die übergebenen Felder, nicht genannte Felder bleiben unberührt.
  • Sonstig Unbestätigtes: die Liste unterstützter CalDAV-Server-Software sowie Rate- oder Parallelitätslimits sind offiziell nicht angegeben. „Nicht angegeben“ beschreibt nur den Dokumentumfang und ist keine Sicherheitsaussage.