termind
Provides add-to-calendar buttons for Apple Calendar so guests can save or update bookings.
Supports read-only ICS subscriptions from Google Calendar and add-to-calendar buttons for Google Calendar.
Syncs calendars with iCloud via CalDAV, including availability lookup and appointment updates.
Syncs calendars with mailbox.org via CalDAV for reading availability and creating appointments.
Sends HMAC-signed webhooks to Make for automation workflows.
Sends HMAC-signed webhooks to n8n for automation workflows.
Syncs calendars with Nextcloud via CalDAV, reading availability and writing appointments.
Supports read-only ICS calendar subscriptions from Proton Calendar.
Provides embedding support and instructions for adding booking pages to Wix sites.
Provides embedding support and instructions for adding booking pages to WordPress sites.
Sends HMAC-signed webhooks to Zapier for automation workflows.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
termind
Schlanke, selbst hostbare Terminbuchung mit eingebauter KI-Schnittstelle (MCP). Eine ruhige Alternative zu Calendly & Co.: eine Instanz pro Person oder kleinem Team, alle Daten in einer SQLite-Datei auf deinem Server, rund 45 MB Arbeitsspeicher.
English: termind is a lightweight, self-hostable scheduling tool (Calendly alternative) with a built-in MCP server so AI assistants can manage bookings. Single container, SQLite, ~45 MB RAM. Booking pages and emails in German and English, admin UI in German. AGPL-3.0.
Screenshots
Buchung für Gäste | Verwaltung |
Ausführliche Anleitung: docs/ANLEITUNG.md
Related MCP server: SavvyCal MCP Server
Was termind kann
Buchungsseiten mit Monatskalender, freien Zeiten in der Zeitzone des Gastes (sichtbar angezeigt), eigenen Formularfeldern, Einwilligung und Bestätigung. Deutsch und Englisch, helles und dunkles Design nach Systemeinstellung, verständliche Fehlermeldungen direkt am Feld.
Terminseiten mit Dauer, Ort (Videolink, eigener Raum pro Termin, vor Ort, Telefon), Puffern, Mindestvorlauf, Buchungsfenster, Raster und optionaler Bestätigung durch dich.
Verfügbarkeit mit mehreren Zeitfenstern pro Tag, Urlaub und abweichenden Tagen. Eine gemeinsame Zeitzone für Profil und Verfügbarkeit, gewählt aus Klarnamen.
Termine im Alltag: Karte „Heute“, Filter nach Terminseite und Zeitraum, Reiter „Abgesagt“, frühere Termine eines Gastes, Notiz mit Autospeichern. Termine verschieben oder selbst eintragen (auch ohne Mail an den Gast und außerhalb der Verfügbarkeit).
Kalender-Abgleich mit Nextcloud, iCloud, mailbox.org, Fastmail & jedem CalDAV-Server (lesen und Termine eintragen) sowie ICS-Abos (Google, Outlook, Proton, nur lesen).
E-Mails über dein eigenes SMTP mit Mail-Assistent (Anbieter-Vorlagen, „Verbindung testen“ vor dem Speichern, Fehler in Klartext): Bestätigung, Anfrage, Erinnerung, Verschiebung, Absage, jeweils mit Kalenderdatei. Betreff mit Datum und Uhrzeit, Zeiten in der Zeitzone des Gastes, Antworten gehen an die richtige Person. Texte editierbar mit Live-Vorschau (auch in Handy-Breite).
Direkt-Knöpfe „Bestätigen“ und „Ablehnen“ in der Anfrage-Mail, als sichere Einmal-Links, die erst nach einem Klick auf der Seite ausgeführt werden.
Erste Schritte: Checkliste mit Fortschritt, Begrüßung und Hinweisen, bis die Buchungsseite startklar ist.
Gäste verschieben oder sagen ab über einen persönlichen Link, ohne Konto, mit Rückfrage, „Bisher“-Anzeige und Kalender-Knöpfen (Apple / Outlook, Google).
Einbettung in jede Webseite mit einer Zeile: im Text, als Button-Popup oder schwebend, für einzelne Terminseiten und für die ganze Profilseite (mit Hinweisen für WordPress, Wix und Jimdo).
KI-Verwaltung per MCP: KI-Assistenten lesen Termine, finden freie Zeiten, buchen, verschieben, pflegen Terminseiten. Alles, was Gäste erreicht oder etwas löscht, braucht erst deine Zustimmung im Chat. Jede Aktion steht im KI-Protokoll.
Webhooks mit HMAC-Signatur für n8n, Make, Zapier.
Datenschutz: keine Cookies und keine fremden Server für Gäste, automatische Anonymisierung nach Frist, Auskunft und Löschung auf Knopfdruck.
Sicherheit: Passwort (Argon2id), Passkeys, Zwei-Faktor-Anmeldung mit 10 Ersatzcodes, „Passwort vergessen“ per Mail-Link, Notfallbefehl für den Server, verschlüsselte Zugangsdaten, strenge Sicherheits-Header. Vor dem Entfernen von Kalendern, Webhooks, Schlüsseln, Zugängen und Passkeys fragt termind nach.
Bedienung: verständliche deutsche Fehlermeldungen, Fachbegriffe in Klartext mit ?-Erklärungen, Einstellungen mit Bereich „Erweitert“, große Touch-Flächen, Tastaturbedienung, gute Kontraste.
Schnellstart (ein Server, eigene Domain)
Voraussetzung: ein kleiner Linux-Server (1 vCPU, 512 MB RAM reichen) mit Docker und eine Domain, die auf ihn zeigt.
git clone https://github.com/gh-samk/termind.git
cd termind/deploy/single
cp .env.example .env # DOMAIN und ACME_EMAIL eintragen
docker compose up -dCaddy holt das HTTPS-Zertifikat automatisch. Den Einrichtungslink findest du im Log:
docker compose logs termind | grep setupNur mit diesem Link lässt sich das erste Konto anlegen, damit niemand Fremdes eine frische Instanz übernimmt. Der Link wird bis zur Einrichtung alle 10 Minuten neu ins Log geschrieben. Rufst du /setup ohne Link auf, kannst du den Code oder den ganzen Link in ein Feld einfügen. Anschließend führt dich die Checkliste „Erste Schritte“ durch Mail-Versand (unter Einstellungen → E-Mail, mit Anbieter-Auswahl und „Verbindung testen“), Verfügbarkeit und die erste Terminseite.
Konfiguration
Variable | Bedeutung | Standard |
| Öffentliche Adresse mit |
|
|
|
|
| Datenbank, Schlüssel und Backups |
|
| Automatisches Backup alle n Stunden, Anzahl behaltener Kopien ( |
|
| Abstand des Kalender-Abgleichs |
|
|
|
|
| Eigener Schlüssel für gespeicherte Passwörter, mind. 16 Zeichen (sonst wird | – |
| Optional: eigener Einrichtungscode (sonst wird einer erzeugt und ins Log geschrieben) | – |
Update
docker compose exec termind node server/index.js backup # vorher sichern
docker compose pull && docker compose up -dDatenbank-Änderungen laufen beim Start automatisch. Was sich pro Version ändert, steht im CHANGELOG.
Neu in 0.2.0: Einrichtungs-Assistent mit Checkliste, Passwort-vergessen und Ersatzcodes, Termine verschieben und eintragen, Direkt-Knöpfe in Anfrage-Mails, überarbeitete Gastseiten und Mails, klarere Bedienung. Betreiber mit lokalem Mail-Relay: Mailserver in privaten Netzen (auch 127.0.0.1) brauchen ab jetzt ALLOW_PRIVATE_HOSTS=true. Ausgesperrt? docker compose exec termind node server/index.js reset-password du@example.de [--disable-2fa] gibt einen Link zum Festlegen eines neuen Passworts aus.
Backups
termind legt täglich eine konsistente Kopie unter /data/backups an. Manuell:
docker compose exec termind node server/index.js backupZum Wiederherstellen den Container stoppen, die Datei als /data/termind.db zurückkopieren und termind.db-wal/-shm löschen. Sichere zusätzlich /data/secret.key: ohne ihn sind gespeicherte Passwörter (SMTP, CalDAV) nach einer Wiederherstellung auf einem anderen Server nicht lesbar.
Viele Instanzen betreiben (Hosting für Kunden)
deploy/cloud/termind-cloud.sh verwaltet beliebig viele, sauber getrennte Instanzen hinter einem gemeinsamen Caddy:
sudo ./termind-cloud.sh init admin@example.de
sudo ./termind-cloud.sh create kunde1 termine.kunde1.de # gibt den Einrichtungslink für den Kunden aus
sudo ./termind-cloud.sh list
sudo ./termind-cloud.sh update --all
sudo ./termind-cloud.sh backup --all # mit RCLONE_REMOTE auch extern
sudo ./termind-cloud.sh restore kunde1 kunde1-20270101T030000Z.tar.gz
sudo ./termind-cloud.sh delete kunde1Jede Instanz läuft mit eigener Datenbank, Speicher-, CPU- und Prozesslimit, schreibgeschütztem Dateisystem und ohne Linux-Capabilities. Backups enthalten Datenbank und Schlüssel, vor jedem Update wird automatisch gesichert.
KI anbinden (MCP)
Endpunkt: https://DEINE-DOMAIN/mcp (Streamable HTTP).
KI-Assistenten mit Connector-Unterstützung (Web, App, ChatGPT): Adresse als eigenen Connector hinzufügen. Die Anmeldung läuft über OAuth 2.1, du bestätigst sie einmal im Browser und wählst Nur lesen oder Verwalten.
Desktop-Clients, Entwickler-Werkzeuge, n8n, Skripte: unter Einstellungen → KI & MCP einen API-Schlüssel erstellen und als
Authorization: Bearer tmd_…mitsenden.
API-Schlüssel und OAuth-Zugänge gelten nur am MCP-Endpunkt, nicht für die Admin-Oberfläche. Sicherheitseinstellungen (Passwort, Passkeys, Zwei-Faktor, neue Schlüssel) lassen sich nur von dir selbst in der Oberfläche ändern.
{
"mcpServers": {
"termind": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://termine.example.de/mcp", "--header", "Authorization: Bearer tmd_…"]
}
}
}Werkzeuge u. a.: get_overview, find_free_slots, list_bookings (Ansichten upcoming, pending, past, cancelled, all), book_appointment, reschedule_booking, cancel_booking, create_event_type, update_weekly_hours, add_exception, update_mail_text, export_personal_data. Aktionen mit Gastkontakt, Datenabfluss (Webhooks) oder Löschen sowie Änderungen an Mail-Texten und Orten liefern zuerst eine Vorschau und laufen erst mit confirm_action.
Hinweis zu Prompt-Injection: Namen und Antworten von Gästen sind fremde Eingaben. termind kennzeichnet sie für die KI als Daten, doch keine KI ist dagegen völlig immun. Lies die Vorschau, bevor du einer Aktion zustimmst, und gib Assistenten, die nur lesen sollen, einen Lese-Schlüssel.
Webseite einbinden
<script src="https://termine.example.de/embed.js" defer></script>
<div data-termind="lena/erstgespraech"></div>
<!-- oder: <button data-termind="lena/erstgespraech" data-mode="popup">Termin buchen</button> -->
<!-- oder: <div data-termind="lena" data-mode="floating" data-label="Termin buchen"></div> -->Optionale Attribute: data-theme="light|dark", data-lang="de|en", data-color="#1d6f63". Nach einer Buchung feuert das Element das Ereignis termind:booked (nur mit dem Status, ohne Personendaten).
Entwicklung
npm install
npm run dev # Oberfläche: http://localhost:5173 (API läuft auf :3317)
npm test # Terminberechnung, Kalender-Parser, SSRF-Schutz, OAuth
npm run typecheck
npm run build && docker build -t termind .Aufbau: server/ (Hono, Drizzle ORM, SQLite/libSQL, Mail-Warteschlange, MCP, OAuth), web/ (React, Vite, Tailwind), shared/ (Typen und Schemas für beide Seiten), deploy/ (Betrieb). Oberfläche, REST-API und MCP nutzen dieselbe Service-Schicht in server/services/, deshalb gelten alle Regeln überall gleich.
Sicherheit
Siehe SECURITY.md. Sicherheitslücken bitte vertraulich melden, nicht als öffentliches Issue.
Lizenz
GNU Affero General Public License v3.0. Wer termind verändert und als Dienst anbietet, muss den geänderten Quellcode den Nutzern zugänglich machen.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
AI-native scheduling: check availability, book meetings, cancel and reschedule via MCP
Let AI assistants record meetings and work with notes, transcripts, contacts, and Drive.
Calendar API for AI agents: events, availability, Google/Microsoft setup, scheduling, and iCal.
Governed memory and workspace for any AI: tasks, calendar, mail and pages, with per-action consent.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to safely manage appointment bookings for appointment-based businesses over MCP, including searching availability, holding, confirming, rescheduling, and canceling bookings, and reading business policies.MIT
- AlicenseAqualityCmaintenanceEnables AI agents to discover bookable time slots, book and cancel meetings, list events, and enable or disable scheduling links. Also supports managing webhooks and exposes write/destructive operations with MCP annotations so clients can confirm before acting.12MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents and MCP clients to discover and call hosted calendar tools, review overlapping meetings, and use governed, authenticated calendar access through PipMCP with one API key.79 npmMIT
- AlicenseAqualityBmaintenanceEnables AI agents to manage appointments, reschedule bookings, look up clients, and add client notes in a user's signed-in business account without requiring an API key.7Elastic 2.0