Skip to content
gh-samkPublic

About

Schlanke, selbst hostbare Terminbuchung (Calendly-Alternative) mit eingebauter KI-Schnittstelle (MCP). Docker, SQLite, ~45 MB RAM. AGPL-3.0.

Topics

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

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.

Buchungsseite von termind mit Kalender und freien Zeiten


Screenshots

Buchung für Gäste Verwaltung
Buchungsformular Termine im Admin-Bereich
Profilseite mit allen Terminseiten Terminseite bearbeiten
Verfügbarkeit mit Wochenzeiten und Ausnahmen KI-Anbindung per MCP mit Protokoll
Mail-Texte mit Live-Vorschau Dunkles Design
Willkommen und Checkliste „Erste Schritte“ nach der Einrichtung Mail-Versand mit Anbieter-Auswahl und Verbindungstest

Buchungsseite auf dem Handy    Admin-Bereich auf dem Handy

Ausführliche Anleitung: docs/ANLEITUNG.md


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 -d

Caddy holt das HTTPS-Zertifikat automatisch. Den Einrichtungslink findest du im Log:

docker compose logs termind | grep setup

Nur 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
PUBLIC_URL Öffentliche Adresse mit https:// (Links in Mails, Passkeys, OAuth) http://localhost:3000
TRUST_PROXY true hinter einem Reverse-Proxy (für korrekte Client-IP, sonst teilen sich alle Besucher die Limits). Im mitgelieferten Setup schon gesetzt false
DATA_DIR Datenbank, Schlüssel und Backups /data
BACKUP_HOURS / BACKUP_KEEP Automatisches Backup alle n Stunden, Anzahl behaltener Kopien (0 = aus) 24 / 7
CALENDAR_SYNC_MINUTES Abstand des Kalender-Abgleichs 5
ALLOW_PRIVATE_HOSTS true erlaubt Kalender, Webhooks und Mail-Server im lokalen Netz (z. B. Nextcloud im LAN, lokales Mail-Relay). Ohne diese Einstellung lehnt termind private Adressen ab false
APP_SECRET Eigener Schlüssel für gespeicherte Passwörter, mind. 16 Zeichen (sonst wird secret.key erzeugt) –
SETUP_TOKEN 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 -d

Datenbank-Änderungen laufen beim Start automatisch. Was sich pro Version ändert, steht im CHANGELOG.

Neu in 1.0.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 backup

Zum 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 kunde1

Jede 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.

About

Schlanke, selbst hostbare Terminbuchung (Calendly-Alternative) mit eingebauter KI-Schnittstelle (MCP). Docker, SQLite, ~45 MB RAM. AGPL-3.0.

Topics

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages