Notion

Full API access to Notion for creating pages, querying databases, and managing blocks programmatically. You'll need an integration key from notion.so/my-integrations and permission sharing on target pages. One catch: this uses the 2025-09-03 API version where databases are now called "data sources" in endpoints, so you'll use `/data_sources/{id}/query` for queries but still reference `database_id` when creating pages as children. The documentation here is solid with curl examples for common operations like creating database entries, updating properties, and appending content blocks. Rate limited to about 3 requests per second, which is fine for automation but won't handle high-volume scenarios.

skills.sh installs: 2.7K
GitHub stars: 382.8K
last updated: Jul 14, 2026

View on GitHub

Install

$ npx -y skills add steipete/clawdis --skill notion --agent claude-code

Installs into .claude/skills of the current project.

Files

Notion

Prefer official ntn CLI. Use curl only when ntn is unavailable or a raw request is clearer.

Setup

npm install -g ntn
ntn --version
ntn login

Script/headless auth:

export NOTION_API_TOKEN=secret_or_ntn_token
export NOTION_API_VERSION=2026-03-11

ntn api sets Authorization and Notion-Version automatically. It uses CLI login by default, or NOTION_API_TOKEN when set.

Inspect

ntn doctor
ntn api ls
ntn api ls --json
ntn api v1/comments --help
ntn api v1/comments --spec -X POST
ntn api v1/comments --docs -X POST

Pages

Markdown-first helpers:

ntn pages get <page-id>
ntn pages get <page-id> --json
ntn pages create --parent page:<page-id> --content '# Title\n\nBody'
ntn pages create --parent data-source:<data-source-id> < page.md
ntn pages update <page-id> --content '# Updated'
ntn pages update <page-id> < page.md
ntn pages trash <page-id> --yes

Notes:

SKILL.md on GitHub