Intégration domotique Notion Calendar, gratuite et open source
Synchronise les bases Notion affichées dans Notion Calendar avec les calendriers Gladys.
Publiée par quentinlegay
- Appareils
- Version 1.0.0
- Nécessite Gladys >=5.2.0
- ★ 0
Retrouvez dans Gladys les bases Notion que vous affichez dans Notion Calendar : planning d'équipe, tâches avec échéance, calendrier éditorial, voyages… Les événements apparaissent dans la vue calendrier de Gladys, déclenchent le rappel « Un événement va commencer », alimentent l'assistant et deux widgets de tableau de bord.
Fonctionnement
Bases Notion (propriété date) ──API Notion──> cette intégration ──> calendriers Gladys
Notion Calendar n'a pas d'API publique : il affiche les bases Notion qui ont une propriété date. L'intégration lit ces mêmes bases avec l'API Notion, puis :
- chaque base (source de données) ayant une propriété date devient un calendrier Gladys, du nom de la base ;
- chaque page datée devient un événement : son titre, sa date (sur la
journée ou avec horaire), son lien Notion et, si la base a une propriété
texte
Lieu/Location, son lieu.
La synchronisation va de Notion vers Gladys, toutes les 15 minutes par défaut. Une page supprimée ou dont la date est vidée disparaît de Gladys à la synchronisation suivante. Seule l'action de scène Ajouter un événement Notion écrit dans Notion.
Les rendez-vous Google ou Outlook que Notion Calendar affiche aussi ne passent pas par Notion : utilisez pour eux l'intégration CalDAV ou Google de Gladys.
Installation
1. Créer une intégration Notion (une fois par personne)
- Ouvrez Mes intégrations Notion et créez une intégration interne dans votre espace de travail.
- Capacités : Lire le contenu suffit. Cochez aussi Insérer du contenu pour utiliser l'action de scène « Ajouter un événement Notion ».
- Copiez le secret de l'intégration (il commence par
ntn_). - Sur chaque base à synchroniser, ouvrez le menu ••• → Connexions et ajoutez votre intégration. Une base non partagée reste invisible.
2. Réglages de l'intégration (administrateur)
Dans l'onglet Configuration :
| Réglage | Défaut | Rôle |
|---|---|---|
| Intervalle de synchronisation | 15 min | Fréquence de lecture de Notion (5 min minimum) |
| Jours conservés dans le passé | 30 | Les événements plus anciens sont retirés de Gladys |
| Jours synchronisés à l'avance | 90 | Horizon de la vue, des rappels et des widgets |
3. Activer « Mes calendriers » (chaque utilisateur)
Les calendriers sont des données personnelles : chaque utilisateur de Gladys active l'intégration pour lui-même, avec son propre secret Notion, dans le bloc Mes calendriers de la page de l'intégration.
- Secret de l'intégration Notion : le secret copié à l'étape 1.
- Bases (facultatif) : liens ou identifiants des bases à synchroniser, séparés par des virgules. Laissez vide pour synchroniser toutes les bases partagées avec l'intégration.
- Propriété date (facultatif) : nom de la propriété à utiliser quand une
base en a plusieurs (par ex.
Échéance). Vide : la première propriété date de la base.
Le bouton Tester les comptes Notion de l'onglet Configuration indique, pour chaque utilisateur, combien de bases datées son secret peut lire.
4. Partager les calendriers utiles
Un calendrier synchronisé est privé au départ : seul son propriétaire le voit. Partagez-le avec la maison (interrupteur Partagé) pour qu'il soit visible sur les tableaux de bord, dans les scènes et par les autres membres. L'interrupteur Synchronisé suspend un calendrier sans le supprimer.
Scènes
Déclencheurs
| Déclencheur | Quand | Variables |
|---|---|---|
| Événement Notion ajouté | Une page datée apparaît dans un calendrier Notion partagé | calendar, name, start, all_day, url |
| Échec de synchro Notion | Un compte cesse de se synchroniser (jeton révoqué, base…) | user, error |
Le déclencheur « Événement Notion ajouté » peut être filtré sur le nom du calendrier (le nom de la base Notion). Il ne se déclenche pas à la toute première synchronisation d'un compte, ni pour les événements créés par l'action de scène ci-dessous.
Le déclencheur natif de Gladys Un événement va commencer fonctionne aussi sur les calendriers Notion partagés.
Actions
| Action | Champs | Sorties |
|---|---|---|
| Synchroniser les calendriers Notion | — | calendars, events, success |
| Ajouter un événement Notion | calendrier, nom, début, fin, lieu | created, url |
| Lire le prochain événement Notion | calendrier (vide : tous) | found, name, start, minutes_until, calendar, url |
- Début / fin : une date (
2026-10-12) pour un événement sur la journée, ou une date-heure avec fuseau (2026-10-12T09:00:00+02:00). Les variables de scène sont acceptées. - Les actions ne voient que les calendriers partagés.
Exemple : chaque matin à 7 h, « Lire le prochain événement Notion », puis si
found est vrai, faire annoncer {{name}} par l'assistant.
Widgets
| Widget | Contenu |
|---|---|
| Agenda Notion | Les prochains événements (1 à 8), filtrables par calendrier, avec lien Notion |
| Résumé Notion | Événements dans les 24 h et 7 jours, délai avant le prochain, état de la synchro |
Les deux widgets proposent un bouton Synchroniser et n'affichent que les calendriers partagés (un tableau de bord peut être affiché sur un écran public).
Dépannage
- « Notion a refusé le jeton » : le secret a été régénéré ou l'intégration supprimée. Copiez le nouveau secret dans Mes calendriers.
- « Une base n'est pas partagée » : une base listée dans « Bases » n'est pas connectée à l'intégration (••• → Connexions), ou le lien est faux.
- Une base n'apparaît pas : elle n'a pas de propriété date, ou elle n'est pas partagée avec l'intégration.
- Un événement de plus de 90 jours qui déborde sur la période n'est pas synchronisé : seules les pages qui commencent au plus 90 jours avant la période sont lues.
- Les journaux de l'intégration (onglet Supervision) détaillent chaque synchronisation ; le secret Notion n'y figure jamais.
Confidentialité
Le secret Notion de chaque utilisateur est conservé par Gladys sans jamais être réaffiché dans l'interface, et
n'est envoyé qu'à api.notion.com. L'intégration ne lit que les bases que
vous avez explicitement partagées avec votre intégration Notion.
Paramètres de configuration
Voici les paramètres demandés par Notion Calendar dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Fonctionnement | section | Non | Chaque utilisateur active l'intégration dans « Mes calendriers » ci-dessous avec son propre jeton Notion. Chaque base Notion ayant une propriété date devient un calendrier Gladys, rafraîchi à l'intervalle choisi ici. Les calendriers sont privés au départ : partagez-les pour les voir sur les tableaux de bord et dans les scènes. |
| Intervalle de synchronisation (minutes) | number | Non | Fréquence de lecture de Notion, pour chaque utilisateur (5 minutes minimum). |
| Jours conservés dans le passé | number | Non | Les événements plus anciens sont retirés de Gladys. |
| Jours synchronisés à l'avance | number | Non | Horizon de la vue calendrier, des rappels et des widgets. |
Comment installer Notion Calendar dans Gladys
- Dans Gladys, ouvrez Intégrations : Notion Calendar apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/quentinlegay/gladys-notion-calendar:1.0.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/quentinlegay/gladys-notion-calendar.
Notion Calendar nécessite Gladys >=5.2.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
Notion Calendar est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par quentinlegay, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation