notion-api

✓Verified·Scanned 2/18/2026

This skill is a minimal Node CLI for the Notion API (run via node scripts/notion-api.mjs) that performs search, queries, and page/block operations. It reads credentials from NOTION_KEY or ~/.config/notion/api_key and makes requests to https://api.notion.com/...; these behaviors are purpose-aligned and expected.

from clawhub.ai·v4f73edc·8.4 KB·0 installs

Scanned from 1.1.0 at 4f73edc · Transparency log ↗

$ vett add clawhub.ai/timenotspace/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

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
# 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

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.