notion-api

# 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 ```bash node scripts/notion-api.mjs search "query" --page-size 10 ``` ### Query a data source (database query) ```bash node scripts/notion-api.mjs query --data-source-id <DATA_SOURCE_ID> --page-size 10 # optionally pass raw JSON body: node scripts/notion-api.mjs query --data-source-id <ID> --body '{"filter": {...}, "sorts": [...], "page_size": 10}' ``` ### Create a page in a database ```bash 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.