Agent skill · software engineering · steipete
notion
Notion CLI/API for pages, Markdown content, data sources, files, comments, search, Workers, and raw API calls.
Why this skill is useful
Adds executable scripts for interacting with the Notion API that extend capabilities beyond standard usage.
What it needs
Requires curl, ntn installed locally. Requires notion account access. About 2k tokens when loaded. Last updated 2026-08-07. 385,400 stars on the source repository.
What this skill does
Notion Prefer official ntn CLI. Use curl only when ntn is unavailable or a raw request is clearer. Setup Script/headless auth: ntn api sets Authorization and Notion-Version automatically. It uses CLI login by default, or NOTIONAPITOKEN when set. Inspect Pages Markdown-first helpers: Notes: pages get prints Markdown with page properties as frontmatter. Content input: --content, stdin, or editor in a TTY. Parent refs: page:<id>, database:<id>, data-source:<id>. For properties/templates/full Pages API, use ntn api v1/pages. Data sources Use resolve when you have a database ID. Query needs a data source ID. Raw API Input syntax: path=value: string body field. path:=json: typed JSON body field. name==value: query parameter. Header:Value: request header. --data '<json>' or stdin JSON for larger bodies. Only one body source per request. Files Workers Workers may require Business/Enterprise plan and workspace enablement. Curl fallback Version notes Current latest API version: 2026-03-11. Use intrash, not archived. Append block positioning uses position, not flat after. transcription block renamed to meetingnotes. Databases can contain multiple data sources; page parents generally use datasourceid.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills steipete/notion