Productivité & documents
Connecter Notion à un agent IA autonome
Un agent Atako connecté à Notion peut lire vos pages et bases, et en créer ou en modifier, mais seulement celles que vous avez explicitement partagées avec lui.
Workflows possibles
Mise à jour hebdomadaire d'une base de suivi
L'agent interroge une base Notion (projets, candidats, comptes clients) avec query_database, recoupe avec des données reçues par email ou par un autre connecteur, crée les nouvelles entrées avec create_page et met à jour les entrées existantes avec update_page. Le format et les propriétés de la base restent ceux définis par votre équipe, l'agent ne fait que remplir la base plus vite qu'un humain ne le ferait chaque lundi matin.
Comptes rendus de réunion structurés
À partir d'un résumé de réunion reçu par un autre canal, l'agent crée une page dans le bon dossier (create_page), puis la structure avec des paragraphes de contexte (append_paragraph), une liste de décisions (append_bulleted_list) et une liste de tâches à cocher pour chaque participant (append_to_do). Les points de vigilance sont mis en avant avec un callout, pour qu'ils sautent aux yeux à la relecture.
Archivage périodique d'une base de connaissances
L'agent interroge une base filtrée par date de dernière modification (query_database), repère les pages qui n'ont pas bougé depuis des mois, laisse un commentaire expliquant pourquoi il propose leur archivage (create_comment), puis les archive (archive_page). Rien n'est perdu : une page archivée reste consultable et peut être restaurée manuellement si besoin, ce qui évite d'accumuler des bases surchargées de contenus périmés que plus personne ne consulte.
Actions du connecteur
query_database (lecture)
Interroge une base avec filtres et tris.
search (lecture)
Recherche des pages ou bases partagées, par titre.
get_page (lecture)
Récupère une page et ses propriétés.
get_database (lecture)
Récupère le schéma d'une base.
list_block_children (lecture)
Lit le contenu détaillé d'une page.
create_page (écriture)
Crée une page dans une base ou sous une page parente.
update_page (écriture)
Met à jour les propriétés d'une page.
append_paragraph (écriture)
Ajoute un paragraphe de texte à une page.
append_to_do (écriture)
Ajoute des cases à cocher à une page.
create_comment (écriture)
Ajoute un commentaire ou répond à un fil existant.
archive_page (écriture)
Archive une page dans la corbeille, réversible.
Prérequis
- Créer une intégration interne sur notion.so/my-integrations, associée à un seul workspace.
- Activer les capabilities Read content, Update content, Insert content, plus les commentaires.
- Copier le secret d'intégration (préfixe ntn_ ou secret_), affiché une seule fois.
- Partager chaque page ou base avec l'intégration via ••• puis Connections.
- Dans Atako, un droit d'administration des intégrations pour accorder le grant à l'agent.
Comment connecter
- 1
Créer l'intégration Notion
Sur notion.so/my-integrations, créer une intégration, choisir le workspace, activer les capabilities, copier le secret.
- 2
Partager les pages avec l'intégration
Ouvrir chaque page ou base à donner à l'agent, cliquer ••• puis Connections, sélectionner l'intégration. Sans cette étape, le token seul ne donne accès à rien.
- 3
Connecter Notion dans Atako
Dans Paramètres puis Intégrations, coller le secret copié à l'étape 1.
- 4
Accorder le grant à l'agent
Depuis la page de l'agent (Intégrations de cet agent) ou depuis la connexion (Gérer les accès), sélectionner les actions précises à autoriser et leur portée (lecture seule ou lecture et écriture).
Pourquoi brancher un agent autonome sur Notion
Notion est souvent l'endroit où une équipe range ce qu'elle sait : bases de suivi, documentation interne, comptes rendus. Le problème, c'est que cette information vieillit vite si personne ne la met à jour. Un agent Atako connecté à Notion via tool calling peut faire ce travail en continu, dans son propre environnement, sans qu'un humain ait à ouvrir la base chaque semaine.
Ce qui change par rapport à une automatisation à déclencheur classique : l'agent tourne en permanence. Il peut recevoir une information par email, la recouper avec ce qui existe déjà dans une base Notion via query_database, puis décider seul s'il faut créer une page ou mettre à jour une entrée existante, dans le cadre des actions qui lui ont été accordées.
Le connecteur Notion couvre 28 actions (13 lecture, 15 écriture) selon la documentation Atako, de la recherche de pages à la création de bases avec leur schéma de propriétés. De quoi couvrir aussi bien le rangement de comptes rendus que la relecture d'une base de connaissances. Un usage typique : un agent qui pilote la communication autour d'une release tient sa documentation Notion à jour en parallèle de ses autres canaux.
Limites et bonnes pratiques
Notion impose un partage explicite, page par page ou base par base. C'est une contrainte au départ, mais aussi un garde-fou : un token qui fuiterait ne donnerait accès qu'à ce qui a été partagé, jamais à tout le workspace.
Le débit de l'API Notion reste modeste : en moyenne trois requêtes par seconde par intégration, avec un plafond par workspace qui varie selon le plan tarifaire. Sur une base de plusieurs milliers de pages, un agent qui doit tout relire devra étaler le travail.
Le connecteur ne permet pas de suppression définitive : archive_page range une page dans la corbeille, récupérable. Comme pour toute intégration Atako, chaque action est soumise à un grant explicite (agent, action, portée) : la connexion seule ne donne aucun accès. Voir le modèle de permissions et les plans.
Cas d'usage associés
Intégrations complémentaires
Questions fréquentes
L'agent peut-il modifier n'importe quelle page de mon workspace Notion ?
Non. L'agent ne voit que les pages et bases explicitement partagées avec l'intégration, via le menu Connections. Même partagée, une page ne peut être modifiée que si le grant de l'agent inclut une action d'écriture avec la portée adéquate.
Faut-il un plan Notion payant pour connecter l'API ?
Non, l'API Notion fonctionne sur le plan gratuit comme sur les plans payants. Ce qui change selon le plan, c'est le plafond de requêtes autorisées par workspace.
Comment révoquer l'accès de l'agent à Notion ?
Deux options complémentaires : retirer l'intégration de la liste des connexions d'une page, ou révoquer la connexion côté Atako. Dans les deux cas, l'accès est coupé immédiatement pour tous les agents concernés.
L'agent peut-il supprimer définitivement une page Notion ?
Non. La seule action de suppression disponible est archive_page, qui déplace la page dans la corbeille sans la détruire. Il n'existe pas d'action de suppression permanente dans ce connecteur.
À lire ensuite
Sources
- Notion Docs, Create a Notion integration · consulté le 4 septembre 2026
- Notion Docs, Request limits · consulté le 4 septembre 2026
CTO d'Atako
Ce contenu a été rédigé par les agents IA d'Atako, puis relu, corrigé et validé par Romain Laodicina, CTO d'Atako.