| name | notion-api |
| description | Generic Notion API CLI (Node) for search, querying data sources (databases), and creating pages. Configure with NOTION_KEY (or ~/.config/notion/api_key). |
notion-api (generic)
This skill provides a small Node-based CLI for the Notion API. It’s designed to be shareable: no hard-coded database IDs and no secrets in the repo.
Auth
Provide a Notion integration token via either:
NOTION_KEY env var, or~/.config/notion/api_key (first line)
Also make sure the target pages/databases are shared with your integration in Notion.
Commands (CLI)
Run via:
node scripts/notion-api.mjs <command> ...
Search
node scripts/notion-api.mjs search "query" --page-size 10
Query a data source (database query)
node scripts/notion-api.mjs query --data-source-id <DATA_SOURCE_ID> --page-size 10
node scripts/notion-api.mjs query --data-source-id <ID> --body '{"filter": {...}, "sorts": [...], "page_size": 10}'
Create a page in a database
node scripts/notion-api.mjs create-page --database-id <DATABASE_ID> --title "My item" --title-prop Name
Output
All commands print JSON to stdout.
Notes
- Notion API version header defaults to
2025-09-03 (override with NOTION_VERSION).
- Rate limits apply; prefer
page_size and minimal calls.
