Produktivität & Dokumente
Notion mit einem autonomen KI-Agenten verbinden
Ein mit Notion verbundener Atako-Agent kann Ihre Seiten und Basen lesen und neue erstellen oder ändern, aber nur jene, die Sie explizit mit ihm geteilt haben.
Mögliche Workflows
Wöchentliche Aktualisierung einer Verfolgungsbasis
Der Agent fragt eine Notion-Basis ab (Projekte, Kandidaten, Kundenkonten) mit query_database, gleicht sie mit per E-Mail oder über einen anderen Konnektor erhaltenen Daten ab, erstellt neue Einträge mit create_page und aktualisiert bestehende mit update_page. Format und Eigenschaften der Basis bleiben die von Ihrem Team definierten, der Agent füllt die Basis nur schneller, als ein Mensch es jeden Montagmorgen tun würde.
Strukturierte Besprechungsprotokolle
Ausgehend von einer über einen anderen Kanal erhaltenen Besprechungszusammenfassung erstellt der Agent eine Seite im richtigen Ordner (create_page) und strukturiert sie dann mit Kontextabsätzen (append_paragraph), einer Entscheidungsliste (append_bulleted_list) und einer abhakbaren Aufgabenliste für jeden Teilnehmer (append_to_do). Wichtige Punkte werden mit einem Callout hervorgehoben, damit sie beim Durchlesen sofort ins Auge fallen.
Regelmäßige Archivierung einer Wissensdatenbank
Der Agent fragt eine nach letztem Änderungsdatum gefilterte Basis ab (query_database), erkennt Seiten, die sich seit Monaten nicht bewegt haben, hinterlässt einen Kommentar mit der Begründung für die vorgeschlagene Archivierung (create_comment) und archiviert sie dann (archive_page). Nichts geht verloren: Eine archivierte Seite bleibt einsehbar und kann bei Bedarf manuell wiederhergestellt werden, was verhindert, dass sich Basen mit veralteten Inhalten anhäufen, die niemand mehr aufruft.
Aktionen des Connectors
query_database (Lesen)
Fragt eine Basis mit Filtern und Sortierung ab.
search (Lesen)
Sucht geteilte Seiten oder Basen nach Titel.
get_page (Lesen)
Ruft eine Seite und ihre Eigenschaften ab.
get_database (Lesen)
Ruft das Schema einer Basis ab.
list_block_children (Lesen)
Liest den detaillierten Inhalt einer Seite.
create_page (Schreiben)
Erstellt eine Seite in einer Basis oder unter einer übergeordneten Seite.
update_page (Schreiben)
Aktualisiert die Eigenschaften einer Seite.
append_paragraph (Schreiben)
Fügt einer Seite einen Textabsatz hinzu.
append_to_do (Schreiben)
Fügt einer Seite abhakbare Kästchen hinzu.
create_comment (Schreiben)
Fügt einen Kommentar hinzu oder antwortet in einem bestehenden Thread.
archive_page (Schreiben)
Archiviert eine Seite in den Papierkorb, reversibel.
Voraussetzungen
- Eine interne Integration auf notion.so/my-integrations erstellen, an einen einzigen Workspace gebunden.
- Die Capabilities Read content, Update content, Insert content sowie Kommentare aktivieren.
- Das Integrationsgeheimnis kopieren (Präfix ntn_ oder secret_), nur einmal angezeigt.
- Jede Seite oder Basis über ••• dann Connections mit der Integration teilen.
- In Atako ein Recht zur Verwaltung der Integrationen, um den Grant an den Agenten zu erteilen.
So verbinden Sie
- 1
Die Notion-Integration erstellen
Auf notion.so/my-integrations eine Integration erstellen, den Workspace wählen, die Capabilities aktivieren, das Geheimnis kopieren.
- 2
Die Seiten mit der Integration teilen
Jede Seite oder Basis öffnen, die dem Agenten gegeben werden soll, auf ••• dann Connections klicken, die Integration auswählen. Ohne diesen Schritt gibt das Token allein keinerlei Zugriff.
- 3
Notion in Atako verbinden
Unter Einstellungen, dann Integrationen das in Schritt 1 kopierte Geheimnis einfügen.
- 4
Den Grant an den Agenten erteilen
Auf der Seite des Agenten (Integrationen verwalten) oder der Verbindung (Zugriff verwalten) die präzisen zu erlaubenden Aktionen und ihren Umfang auswählen (nur Lesen oder Lesen und Schreiben).
Warum einen autonomen Agenten mit Notion verbinden
Notion ist oft der Ort, an dem ein Team sein Wissen ablegt: Verfolgungsbasen, interne Dokumentation, Protokolle. Das Problem ist, dass diese Information schnell veraltet, wenn niemand sie pflegt. Ein über Tool-Calling mit Notion verbundener Atako-Agent kann diese Arbeit fortlaufend erledigen, in seiner eigenen Umgebung, ohne dass ein Mensch die Basis jede Woche öffnen muss.
Was sich gegenüber einer klassischen Trigger-Automatisierung ändert: Der Agent läuft dauerhaft. Er kann eine Information per E-Mail erhalten, sie über query_database mit dem abgleichen, was bereits in einer Notion-Basis existiert, und dann allein entscheiden, ob eine Seite erstellt oder ein bestehender Eintrag aktualisiert werden muss, im Rahmen der ihm erteilten Aktionen.
Der Notion-Konnektor deckt laut Atako-Dokumentation 28 Aktionen ab (13 Lesen, 15 Schreiben), von der Seitensuche bis zur Erstellung von Basen mit ihrem Eigenschaftsschema. Genug, um sowohl die Ablage von Protokollen als auch das Durchgehen einer Wissensdatenbank abzudecken. Ein typischer Einsatz: Ein Agent, der die Kommunikation rund um eine Release steuert, hält parallel zu seinen anderen Kanälen die Notion-Dokumentation aktuell.
Grenzen und bewährte Praktiken
Notion verlangt eine explizite Freigabe, Seite für Seite oder Basis für Basis. Das ist zunächst eine Einschränkung, aber auch ein Sicherheitsnetz: Ein durchgesickertes Token gäbe nur Zugriff auf das Geteilte, nie auf den gesamten Workspace.
Der Durchsatz der Notion-API bleibt bescheiden: im Schnitt drei Anfragen pro Sekunde pro Integration, mit einer je nach Tarif variierenden Obergrenze pro Workspace. Bei einer Basis mit mehreren Tausend Seiten muss ein Agent, der alles durchgehen soll, die Arbeit strecken.
Der Konnektor erlaubt kein permanentes Löschen: archive_page legt eine Seite wiederherstellbar in den Papierkorb. Wie bei jeder Atako-Integration unterliegt jede Aktion einem expliziten Grant (Agent, Aktion, Umfang): Die Verbindung allein gibt keinerlei Zugriff. Siehe das Berechtigungsmodell und die Preise.
Verwandte Anwendungsfälle
Passende Integrationen
Häufig gestellte Fragen
Kann der Agent jede beliebige Seite meines Notion-Workspaces ändern?
Nein. Der Agent sieht nur die Seiten und Basen, die explizit über das Menü Connections mit der Integration geteilt wurden. Selbst geteilt, kann eine Seite nur geändert werden, wenn der Grant des Agenten eine Schreibaktion mit dem passenden Umfang enthält.
Braucht man einen kostenpflichtigen Notion-Plan, um die API zu verbinden?
Nein, die Notion-API funktioniert im kostenlosen wie in den kostenpflichtigen Plänen. Was sich je nach Plan ändert, ist die Obergrenze der pro Workspace erlaubten Anfragen.
Wie widerruft man den Zugriff des Agenten auf Notion?
Zwei ergänzende Optionen: die Integration aus der Verbindungsliste einer Seite entfernen, oder die Verbindung bei Atako widerrufen. In beiden Fällen ist der Zugriff für alle betroffenen Agenten sofort unterbrochen.
Kann der Agent eine Notion-Seite endgültig löschen?
Nein. Die einzige verfügbare Löschaktion ist archive_page, die die Seite in den Papierkorb verschiebt, ohne sie zu zerstören. In diesem Konnektor gibt es keine Aktion für permanentes Löschen.
Als Nächstes lesen
Quellen
- Notion Docs, Create a Notion integration · abgerufen am 4. September 2026
- Notion Docs, Request limits · abgerufen am 4. September 2026
CTO bei Atako
Dieser Inhalt wurde von den KI-Agenten von Atako verfasst und anschließend von Romain Laodicina, CTO von Atako, geprüft, korrigiert und freigegeben.