Notion Calendar Smart-Home-Integration, kostenlos und Open Source
Synchronisiert die in Notion Calendar angezeigten Notion-Datenbanken mit den Gladys-Kalendern.
Veröffentlicht von quentinlegay
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.2.0
- ★ 0
Holen Sie die Notion-Datenbanken, die Sie in Notion Calendar anzeigen, in Gladys: Teamplanung, Aufgaben mit Fälligkeitsdatum, Redaktionskalender, Reisen… Die Termine erscheinen in der Kalenderansicht von Gladys, lösen die Erinnerung „Ein Termin steht bevor“ aus und versorgen den Assistenten sowie zwei Dashboard-Widgets.
Funktionsweise
Notion-Datenbanken (Datumseigenschaft) ──Notion-API──> diese Integration ──> Gladys-Kalender
Notion Calendar hat keine öffentliche API: Es zeigt die Notion-Datenbanken an, die eine Datumseigenschaft haben. Die Integration liest genau diese Datenbanken über die Notion-API und dann:
- wird jede Datenbank (Datenquelle) mit Datumseigenschaft zu einem Gladys-Kalender, benannt nach der Datenbank;
- wird jede datierte Seite zu einem Termin: Titel, Datum (ganztägig oder
mit Uhrzeit), Notion-Link und, wenn die Datenbank eine Texteigenschaft
Location/Ort/Lieu/Lugarhat, der Ort.
Die Synchronisierung läuft von Notion nach Gladys, standardmäßig alle 15 Minuten. Eine gelöschte Seite oder eine Seite ohne Datum verschwindet bei der nächsten Synchronisierung aus Gladys. Nur die Szenen-Aktion Notion-Termin hinzufügen schreibt in Notion.
Die Google- oder Outlook-Termine, die Notion Calendar ebenfalls anzeigt, laufen nicht über Notion: Verwenden Sie dafür die CalDAV- oder Google-Integration von Gladys.
Einrichtung
1. Eine Notion-Integration erstellen (einmal pro Person)
- Öffnen Sie Meine Notion-Integrationen und erstellen Sie in Ihrem Workspace eine interne Integration.
- Fähigkeiten: Inhalte lesen genügt. Haken Sie zusätzlich Inhalte einfügen an, um die Szenen-Aktion „Notion-Termin hinzufügen“ zu nutzen.
- Kopieren Sie das Secret der Integration (es beginnt mit
ntn_). - Öffnen Sie in jeder zu synchronisierenden Datenbank das Menü ••• → Verbindungen und fügen Sie Ihre Integration hinzu. Eine nicht geteilte Datenbank bleibt unsichtbar.
2. Einstellungen der Integration (Administrator)
Im Tab Konfiguration:
| Einstellung | Standard | Zweck |
|---|---|---|
| Synchronisierungsintervall | 15 min | Wie oft Notion gelesen wird (mindestens 5 Minuten) |
| Aufbewahrte vergangene Tage | 30 | Ältere Termine werden aus Gladys entfernt |
| Im Voraus synchronisierte Tage | 90 | Zeithorizont der Ansicht, Erinnerungen und Widgets |
3. „Meine Kalender“ aktivieren (jeder Nutzer)
Kalender sind persönliche Daten: Jeder Gladys-Nutzer aktiviert die Integration für sich selbst, mit seinem eigenen Notion-Secret, im Block Meine Kalender der Integrationsseite.
- Secret der Notion-Integration: das in Schritt 1 kopierte Secret.
- Datenbanken (optional): Links oder IDs der zu synchronisierenden Datenbanken, durch Kommas getrennt. Leer lassen, um alle mit der Integration geteilten Datenbanken zu synchronisieren.
- Datumseigenschaft (optional): Name der zu verwendenden Eigenschaft,
wenn eine Datenbank mehrere hat (z. B.
Fällig). Leer: die erste Datumseigenschaft der Datenbank.
Die Schaltfläche Notion-Konten testen im Tab Konfiguration zeigt für jeden Nutzer, wie viele datierte Datenbanken sein Secret lesen kann.
4. Die wichtigen Kalender teilen
Ein synchronisierter Kalender ist zunächst privat: Nur sein Besitzer sieht ihn. Teilen Sie ihn mit dem Haushalt (Schalter Geteilt), um ihn auf den Dashboards, in den Szenen und für die anderen Mitglieder anzuzeigen. Der Schalter Synchronisiert pausiert einen Kalender, ohne ihn zu löschen.
Szenen
Auslöser
| Auslöser | Wann | Variablen |
|---|---|---|
| Notion-Termin hinzugefügt | Eine datierte Seite erscheint in einem geteilten Notion-Kalender | calendar, name, start, all_day, url |
| Notion-Synchronisierung fehlgeschlagen | Ein Konto synchronisiert nicht mehr (widerrufenes Token, nicht geteilte DB) | user, error |
Der Auslöser „Notion-Termin hinzugefügt“ kann nach dem Kalendernamen (dem Namen der Notion-Datenbank) gefiltert werden. Er wird weder bei der allerersten Synchronisierung eines Kontos ausgelöst noch für die Termine, die von der unten stehenden Szenen-Aktion erstellt werden.
Der eingebaute Gladys-Auslöser Ein Termin steht bevor funktioniert auch mit den geteilten Notion-Kalendern.
Aktionen
| Aktion | Felder | Ausgaben |
|---|---|---|
| Notion-Kalender synchronisieren | — | calendars, events, success |
| Notion-Termin hinzufügen | Kalender, Name, Beginn, Ende, Ort | created, url |
| Nächsten Notion-Termin abrufen | Kalender (leer: alle) | found, name, start, minutes_until, calendar, url |
- Beginn / Ende: ein Datum (
2026-10-12) für einen ganztägigen Termin oder ein Datum mit Uhrzeit und Zeitzonenversatz (2026-10-12T09:00:00+02:00). Szenenvariablen werden akzeptiert. - Die Aktionen sehen nur die geteilten Kalender.
Beispiel: jeden Morgen um 7 Uhr „Nächsten Notion-Termin abrufen“, dann, wenn
found wahr ist, den Assistenten {{name}} ansagen lassen.
Widgets
| Widget | Inhalt |
|---|---|
| Notion-Agenda | Die nächsten Termine (1 bis 8), nach Kalender filterbar, mit ihrem Notion-Link |
| Notion-Übersicht | Termine in 24 h und 7 Tagen, Zeit bis zum nächsten, Synchronisierungsstatus |
Beide Widgets bieten eine Schaltfläche Synchronisieren und zeigen nur die geteilten Kalender (ein Dashboard kann auf einem öffentlichen Bildschirm hängen).
Fehlerbehebung
- „Notion hat das Token abgelehnt“: Das Secret wurde neu erzeugt oder die Integration gelöscht. Fügen Sie das neue Secret unter Meine Kalender ein.
- „Eine Datenbank ist nicht geteilt“: Eine unter „Datenbanken“ aufgeführte Datenbank ist nicht mit der Integration verbunden (••• → Verbindungen), oder der Link ist falsch.
- Eine Datenbank erscheint nicht: Sie hat keine Datumseigenschaft oder ist nicht mit der Integration geteilt.
- Ein Termin, der länger als 90 Tage ist und in den Zeitraum hineinragt, wird nicht synchronisiert: Es werden nur Seiten gelesen, die höchstens 90 Tage vor dem Zeitraum beginnen.
- Die Logs der Integration (Tab Überwachung) beschreiben jede Synchronisierung; das Notion-Secret erscheint dort nie.
Datenschutz
Das Notion-Secret jedes Nutzers wird von Gladys gespeichert, in der
Oberfläche nie wieder angezeigt und nur an api.notion.com gesendet. Die
Integration liest nur die Datenbanken, die Sie ausdrücklich mit Ihrer
Notion-Integration geteilt haben.
Konfigurationseinstellungen
Diese Einstellungen fragt Notion Calendar in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Funktionsweise | section | Nein | Jeder Nutzer aktiviert die Integration unten unter „Meine Kalender“ mit seinem eigenen Notion-Token. Jede Notion-Datenbank mit einer Datumseigenschaft wird zu einem Gladys-Kalender, der im hier gewählten Intervall aktualisiert wird. Kalender sind zunächst privat: Teilen Sie sie, um sie auf den Dashboards und in den Szenen zu sehen. |
| Synchronisierungsintervall (Minuten) | number | Nein | Wie oft Notion gelesen wird, für jeden Nutzer (mindestens 5 Minuten). |
| Aufbewahrte vergangene Tage | number | Nein | Ältere Termine werden aus Gladys entfernt. |
| Im Voraus synchronisierte Tage | number | Nein | Zeithorizont der Kalenderansicht, der Erinnerungen und der Widgets. |
So installierst du Notion Calendar in Gladys
- Öffne in Gladys Integrationen: Notion Calendar erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/quentinlegay/gladys-notion-calendar:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/quentinlegay/gladys-notion-calendar.
Notion Calendar benötigt Gladys >=5.2.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Notion Calendar ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von quentinlegay veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation