Notion Knowledge Capture

Überführt Gespräche und Notizen in verknüpfte, strukturierte Notion-Seiten.

Notion Knowledge Capture ist ein offizieller OpenAI-Skill aus dem kuratierten Skills-Repository. Laut Anbieter unterstützt er Codex dabei, Gespräche und Notizen in strukturierte, verknüpfte Notion-Seiten zu überführen. Im Mittelpunkt steht nicht die allgemeine Recherche in einem Wissensbestand und auch nicht die Vorbereitung eines Meetings, sondern der gezielte Übergang von flüchtigem Gesprächskontext zu einer wiederverwendbaren Seite. Der Skill unterscheidet dafür zwischen Entscheidungen, Anleitungen, häufigen Fragen, Konzepten, Lernnotizen und Dokumentation. Diese klare Einordnung hilft, eine passende Struktur und Zielgruppe zu wählen, bevor Inhalte geschrieben werden.

Den richtigen Inhalt bestimmen

Am Anfang stehen Zweck, Zielgruppe, Aktualität und die Frage, ob ein neuer Eintrag angelegt oder eine bestehende Seite fortgeschrieben werden soll. Ein Entscheidungseintrag braucht andere Belege und Felder als eine How-to-Seite. Eine FAQ sollte Fragen verständlich formulieren und Antworten kurz mit weiterführenden Quellen verbinden. Bei einer Lernnotiz kann die Entwicklung des Verständnisses wichtiger sein als eine formale Entscheidung. Laut offizieller Anleitung soll Codex außerdem klären, ob der Inhalt für ein Team-Wiki, eine Anleitung, eine FAQ, ein Entscheidungsprotokoll, eine Lernsammlung oder eine Dokumentationsdatenbank bestimmt ist.

Ziel und Schema prüfen

Vor dem Schreiben wird die passende Notion-Datenbank oder Vorlage gesucht. Bestehende Seiten werden mit der vorgesehenen Notion-Suche gefunden und einzeln abgerufen, damit neue Inhalte verknüpft und nicht versehentlich doppelt angelegt werden. Die tatsächlichen Eigenschaften der Datenbank müssen geprüft werden. Titel, Tags, Verantwortliche, Status, Datumsfelder und Relationen dürfen nicht vorausgesetzt werden, weil Arbeitsbereiche unterschiedliche Schemata und Berechtigungen haben. Wenn mehrere Datenbanken passen, sollte die verantwortliche Person das Ziel bestätigen. Die Skill-Datei verweist auf Referenzvorlagen für Wiki, How-to, FAQ, Entscheidung, Lernen und Dokumentation.

Erfassen, erstellen und verlinken

Aus dem Gespräch werden Fakten, Entscheidungen, Begründungen, offene Fragen, Aufgaben und Quellenlinks herausgearbeitet. Entscheidungen sollten Alternativen, Gründe und Ergebnis festhalten. Anleitungen benötigen Voraussetzungen, Handlungsschritte, Links zu relevanten Materialien und Randfälle. Danach wird eine Seite mit der vorhandenen Datenbankstruktur erstellt oder eine vorhandene Seite aktualisiert. Hub-Seiten, verwandte Dokumente und zuständige Teams werden über Relationen oder Rückverweise verbunden. Wenn Folgeaufgaben entstehen, können sie laut Anbieter in einer passenden Datenbank angelegt und mit dem neuen Eintrag verknüpft werden.

Grenzen und Verantwortung

Der Skill ist kein Notion-Ersatz, keine Datenbank und kein Berechtigungssystem. Er garantiert weder die Richtigkeit der Gesprächsinhalte noch die Aktualität verknüpfter Seiten. Vor jeder Änderung müssen Zielbereich, Freigaben, sensible Daten und die Wirkung von Status- oder Eigentümeränderungen geprüft werden. Ein Notion-MCP muss in der Codex-Umgebung verfügbar sein. Ist die Verbindung nicht eingerichtet, soll der Ablauf pausieren und die offizielle Einrichtung erklären, statt Quellen oder Seiten zu erfinden. Die Verbindung nutzt OAuth und kann einen Neustart von Codex erfordern. Auch wenn Notion lokal erreichbar wirkt, können Inhalte an den ausgewählten Modellanbieter übertragen werden. Deshalb bleiben Datenschutz, Zugriffskontrolle, Faktenprüfung und Freigabe beim Menschen. Der Skill ist dauerhaft katalogtauglich, weil er einen stabilen, klar abgegrenzten Wissenspflegeprozess beschreibt und nicht an ein einmaliges Ereignis gebunden ist.

Quellenlage

Diese Beschreibung basiert auf der offiziellen SKILL.md im OpenAI-Repository und der offiziellen OpenAI-Dokumentation zu Codex-Anwendungsfällen mit verbundenen Notion-Arbeitsabläufen. Laut Anbieter können sich Werkzeuge, Vorlagen und Integrationen weiterentwickeln. Vor produktiven Änderungen sollten Nutzerinnen und Nutzer die aktuelle Quelle, die eigene Notion-Struktur und ihre Berechtigungen prüfen. Der Skill verbessert Nachvollziehbarkeit und Wiederverwendung, ersetzt aber weder redaktionelle Prüfung noch organisatorische Verantwortlichkeit.

Installationsanleitung

Was Notion Knowledge Capture ist und wofür es gebraucht wird

Notion Knowledge Capture ist ein Skill aus dem offiziellen Repository openai/skills, dort im kuratierten Verzeichnis skills/.curated abgelegt, und primär für den Einsatz mit OpenAI Codex konzipiert. Laut Anbieter wandelt der Skill Konversationen, Notizen und Entscheidungen in strukturierte, verlinkbare Notion-Seiten um, etwa für Team-Wikis, Anleitungen, FAQ-Sammlungen oder Entscheidungsprotokolle. Der Kerngedanke ist, dass in Chats mit einem KI-Agenten häufig wertvolles Wissen entsteht, das ohne bewusste Nachbearbeitung schnell wieder verloren geht. Der Skill automatisiert den Schritt, dieses Wissen in eine dauerhaft auffindbare Form zu bringen, indem er den richtigen Notion-Datenbanktyp auswählt, den Inhalt entsprechend strukturiert und Verknüpfungen zu verwandten Seiten anlegt. Das ist besonders für Teams relevant, die Codex oder ähnliche Agenten regelmäßig für Recherche, Architekturentscheidungen oder Debugging einsetzen und diese Ergebnisse nicht in Chatverläufen versanden lassen wollen.

Schritt 1: Voraussetzungen

Technische Voraussetzung ist eine funktionierende Verbindung zwischen dem Coding-Agenten und Notion über das Model Context Protocol, kurz MCP. Laut der Skill-Dokumentation wird dafür der Notion-MCP-Server über den Befehl codex mcp add notion mit der URL https://mcp.notion.com/mcp eingebunden. Zusätzlich muss in der Codex-Konfigurationsdatei config.toml die Option rmcp_client auf true gesetzt oder der Codex-Start mit dem Flag --enable rmcp_client versehen werden, da sonst keine Remote-MCP-Verbindung zustande kommt. Danach ist eine Anmeldung per OAuth über codex mcp login notion erforderlich, wofür ein gültiges Notion-Konto mit Schreibrechten auf die Ziel-Workspace nötig ist. Ohne diese Einrichtung schlägt jeder Versuch fehl, eine Seite zu erstellen oder zu aktualisieren.

Schritt 2: Einrichtung Schritt für Schritt

Zunächst wird der Notion-MCP-Server wie beschrieben registriert und die Remote-MCP-Unterstützung aktiviert. Nach der erfolgreichen OAuth-Anmeldung muss Codex einmal neu gestartet werden, damit die Verbindung vollständig aktiv wird. Im eigentlichen Arbeitsablauf klärt der Skill zunächst, was festgehalten werden soll, etwa eine Entscheidung, eine Anleitung oder eine FAQ, und für welches Publikum. Anschließend identifiziert er anhand der im Skill mitgelieferten Referenzdateien die passende Notion-Datenbank und deren Schema, durchsucht bestehende Seiten mit dem Werkzeug notion-search, um Dopplungen zu vermeiden, und erstellt dann über notion-create-pages eine neue Seite mit Zusammenfassung, Kontext, Quellenlinks und Tags. Bereits bestehende Seiten werden stattdessen mit notion-update-page ergänzt, und abschließend werden Verweise von übergeordneten Hub-Seiten angelegt.

Sicherheit und Best Practices

Da der Skill über MCP direkten Schreibzugriff auf einen Notion-Workspace erhält, sollte der verbundene Notion-Account nur die Berechtigungen besitzen, die für die vorgesehene Nutzung wirklich nötig sind, um versehentliche oder unerwünschte Änderungen an sensiblen Bereichen zu vermeiden. Es empfiehlt sich, vor dem produktiven Einsatz in einem Testbereich zu prüfen, ob die erzeugten Seiten korrekt formatiert und verlinkt werden. Da OAuth-Zugangsdaten dauerhaft mit dem Codex-Profil verknüpft bleiben, sollte der Zugriff bei Bedarf über die Notion-Kontoeinstellungen widerrufen werden können. Der Anbieter weist zudem darauf hin, bei Aktualisierungen bestehender Seiten den Verlauf beziehungsweise eine kurze Änderungsnotiz zu ergänzen, damit spätere Leser nachvollziehen können, wann und warum ein Eintrag verändert wurde.

Praxisbeispiel und Grenzen

Ein Praxisbeispiel ist ein Architektur-Review-Gespräch mit Codex, aus dem am Ende eine strukturierte Entscheidungsseite im Notion-Entscheidungsprotokoll entsteht, komplett mit Alternativen, Begründung und Verknüpfung zum betroffenen Projekt. Die Grenzen liegen darin, dass die Qualität der erzeugten Seite stark von der Qualität des ursprünglichen Gesprächs abhängt und der Skill keine inhaltliche Prüfung im Sinne einer Faktenkontrolle vornimmt, sondern lediglich strukturiert, was im Gespräch vorhanden war. Außerdem ist die Funktionalität an eine funktionierende, autorisierte MCP-Verbindung gebunden, sodass Nutzer ohne Notion-Zugang oder ohne die Möglichkeit, MCP-Server zu konfigurieren, den Skill nicht sinnvoll einsetzen können.

Kostenlos
Anbieter
OpenAI
Lizenz
MIT
Zuletzt geprüft
09.09.2026

Repository und Dokumentation

Kategorien

Kompatibel mit

Codex