notion · openai — Codex plugin: what it does, how to install
Brings Notion documentation, research synthesis, and meeting planning directly into Codex workflows.
Open on GitHubWhat notion does
This plugin connects Codex with Notion to handle project documentation and task management. It bundles skills for converting technical specifications into tasks and recording project decisions into workspace pages.
The bundle lives inside the plugins/notion directory. Its structure relies on the manifest .codex-plugin/plugin.json alongside agent metadata in agents/openai.yaml. Every bundled skill depends on the connection defined in .app.json. Calls fail when this link is missing.
What it helps with
- break down Notion project specs into implementation tasks
- prepare meeting agendas and context from workspace notes
- synthesize research across docs into structured reports
- record conversation outcomes and decisions into durable pages
Example prompts for the agent
- Turn the Notion architecture spec into a step-by-step implementation plan
- Draft a meeting agenda and pre-read doc using notes from our Notion space
- Save the final decisions from this thread into our Notion project log
Questions about notion
How to install notion in Codex?
The plugin resides under plugins/notion in the openai/plugins repository. Codex reads its configuration through the .codex-plugin/plugin.json manifest.
What does the notion plugin do?
It turns project specifications into actionable tasks and captures team decisions into structured Notion pages.
What dependencies are needed for the notion plugin?
It requires a linked Notion connection configured through .app.json, which gives the bundled skills access to the workspace.
Source text
notion · MIT
# Notion Plugin
This plugin packages Notion-driven documentation and planning workflows in
`plugins/notion`.
It currently includes these skills:
- `notion-spec-to-implementation`
- `notion-research-documentation`
- `notion-meeting-intelligence`
- `notion-knowledge-capture`
## What It Covers
- turning Notion specs into implementation plans, tasks, and progress updates
- researching across Notion content and publishing structured briefs or reports
- preparing meeting agendas and pre-reads using Notion context
- capturing conversations, decisions, and notes into durable Notion pages
## Plugin Structure
The plugin now lives at:
- `plugins/notion/`
with this shape:
- `.codex-plugin/plugin.json`
- required plugin manifest
- defines plugin metadata and points the runtime at the plugin contents
- `.app.json`
- plugin-local app manifest
- points the runtime at the connected Notion app used by the bundled skills
- `agents/`
- plugin-level agent metadata
- currently includes `agents/openai.yaml` for the OpenAI surface
- `skills/`
- the actual skill payload
- each skill keeps the normal skill structure (`SKILL.md`, optional
`agents/`, `references/`, `assets/`, `scripts/`)
## Notes
This plugin is app-backed through `.app.json` and uses the connected Notion
integration for the bundled skills.
Plugin-level assets and `agents/openai.yaml` are wired into the manifest and
the bundled skill surface.
© Notion · MIT · openai/plugins
Similar plugins
All plugins for Notes, tasks and projects →notion by other authors comes first.