notion

Read and write Notion pages, blocks, databases, and data sources through a local integration token.

Important

Use the script in this skill directory; invoke with bun.
Secrets live in the skill's .env file; never print or read that file into chat.
- Claude Code: .claude/skills/notion/.env
- Codex: .agents/skills/notion/.env
.env is gitignored.
The default Notion API version is 2026-03-11. Override with NOTION_VERSION only when the task requires an older API contract.
Notion integrations only see pages/databases explicitly shared with the connection.
Write operations change real Notion content. Confirm intent before creating, appending, updating, archiving, trashing, or locking pages.
Page metadata is not page content. Use blocks --id PAGE_ID or page --id PAGE_ID --content to read page body blocks.
For current Notion APIs, query rows through data sources: query-data-source --id DATA_SOURCE_ID. Retrieve a database first if you only have a database ID.