Awesome-openclaw-skills notion-api

Generic Notion API CLI (Node) for search, querying data sources (databases), and creating pages. Configure with NOTION_KEY (or ~/.config/notion/api_key).

install

source · Clone the upstream repo

git clone https://github.com/sundial-org/awesome-openclaw-skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/sundial-org/awesome-openclaw-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/notion-api" ~/.claude/skills/sundial-org-awesome-openclaw-skills-notion-api && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/sundial-org/awesome-openclaw-skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/notion-api" ~/.openclaw/skills/sundial-org-awesome-openclaw-skills-notion-api && rm -rf "$T"

manifest: skills/notion-api/SKILL.md

source content

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.