Notion CLI Skill

Use the notion binary from this repo to operate Notion. Prefer the local build when developing.

Install

• Homebrew: brew install inforix/tap/notion-cli
• Release binary: download from GitHub releases and place on PATH
• Local build: go build -o ./bin/notion ./src/cmd/notion

Auth

Set a Notion integration token in the environment:

export NOTION_TOKEN=YOUR_TOKEN

Optional: store the token with the CLI (if supported):

notion auth set --token YOUR_TOKEN

Commands

Auth

notion auth set --token YOUR_TOKEN
notion auth status
notion auth clear

Pages

notion pages list --query "Project" --all
notion pages get <page_id>
notion pages create --body @page.json
notion pages update <page_id> --body @update.json
notion pages archive <page_id>
notion pages export <page_id> --assets=download -o page.md

Databases

notion databases get <db_id>
notion databases query <db_id> --body @query.json
notion databases create --body @database.json
notion databases update <db_id> --body @update.json

Blocks

notion blocks get <block_id>
notion blocks update <block_id> --body @block.json
notion blocks children append <block_id> --body @children.json

Users

notion users list --all
notion users get <user_id>

Comments

notion comments list --page-id <page_id>
notion comments list --block-id <block_id>
notion comments create --body @comment.json

Search

notion search --body @query.json

Examples

notion --version
notion pages list --query "Project"
notion pages export <page_id>
notion pages get <page_id>
notion pages create --body @page.json
notion pages update <page_id> --body @update.json
notion pages archive <page_id>
notion databases query <db_id> --body @query.json
notion blocks children append <block_id> --body @children.json
notion users list --all
notion comments list --page-id <page_id>
notion search --body @query.json
notion files create --body @file-upload.json
notion files read <file_upload_id>
notion files list --page-size 100
notion files read --body @file.json --output ./downloads/

Notes

• The CLI uses the Notion API and includes a Notion-Version header by default.
• Use --notion-version to override when testing a specific API version.
• Use --page-size, --cursor, and --all for list pagination.
• Use --format to render Go templates from JSON output.
• Use --version or -V to print the CLI version and exit.