notion
Notion CLI/API for pages, Markdown content, data sources, files, comments, search, Workers, and raw API calls.
npx skills add Health-Yang/MineEcho --skill notion --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Notion Prefer official `ntn` CLI. Use curl only when `ntn` is unavailable or a raw request is clearer. ## Setup ```bash npm install -g ntn ntn --version ntn login ``` Script/headless auth: ```bash 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 ```bash 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: ```bash 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: - `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 sour
- Setup
- Inspect
- Pages
- Data sources
- Raw API
- Files
- Workers
- Curl fallback
- Version notes
npm install -g ntn ntn --version ntn login export NOTION_API_TOKEN=secret_or_ntn_token export NOTION_API_VERSION=2026-03-11 ntn doctor ntn api ls ntn api ls --json ntn api v1/comments --help ntn api v1/comments --spec -X POST
What does the notion skill do?
Notion CLI/API for pages, Markdown content, data sources, files, comments, search, Workers, and raw API calls.
How do I install it?
Run `npx skills add Health-Yang/MineEcho --skill notion --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From Health-Yang/MineEcho, a repository with 248 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.
