onotion

A modern, full-featured Notion CLI.

Installation

``bash
npm install -g onotion
`

Setup

1. Create a Notion integration at https://www.notion.so/my-integrations
2. Copy your Internal Integration Token
3. Run:

`bash
onotion auth login
`

Usage

$3

`bash
onotion auth login # Store API token
onotion auth logout # Remove credentials
onotion auth whoami # Show current user
`

$3

`bash
onotion search "meeting notes"
onotion search "project" --type page
onotion search "tasks" --type database
`

$3

`bash
onotion db list # List all databases
onotion db query # Query database
onotion db query --filter '{"property":"Status","select":{"equals":"Done"}}'
onotion db schema # Show database schema
onotion db create -p -t "My Database"
`

$3

`bash
onotion page get # Get page details
onotion page get --content # Include page content
onotion page create -p -t "New Page"
onotion page create -p --database -t "New Entry"
onotion page update --icon "🚀"
onotion page append -c "New paragraph"
onotion page append --children-file blocks.json
onotion page delete
`

$3

`bash
onotion block get
onotion block list
onotion block append -c "Content" --type heading_1
onotion block append --children '[{"object":"block","type":"heading_2","heading_2":{"rich_text":[{"type":"text","text":{"content":"Hi"}}]}}]'
onotion block delete
`

Output Formats

All commands support four output formats:

`bash
onotion db list # Table (default)
onotion db list -o json # JSON
onotion db list -o plain # Plain text
onotion db list -o compact # JSONL with flattened fields
`

Fields and streaming:

`bash
onotion db query -o json --fields id,title,status
onotion db query -o compact --fields id,title,status
onotion db query -o compact --stream --limit 1000
`

Note: --stream is supported with -o json or -o compact.

Configuration

Config is stored in ~/.config/onotion/config.json.

Releases

Publishing is handled by CI on every push to main`. The pipeline auto-increments the patch version and publishes to npm, so do not manually tag or publish versions.

License

MIT