A CLI for the Notion API — agent-first, human-friendly.
$ notion pages list --database=Tasks -f Status -f Priority
ID TITLE STATUS PRIORITY CREATED
2f452097-527f-80e1-86df-e5a7719d75d9 Fix login bug In progress High 2026-02-18
3a561098-638f-91f2-97ef-f6b8820e86e0 Update docs Not started Medium 2026-02-17
This CLI is available as an open agent skill for AI assistants including Claude Code, OpenClaw, Codex, Cursor, GitHub Copilot, and 35+ agents.
npx skills add dedene/notion-clibrew install dedene/tap/notiongo install github.com/dedene/notion-cli/cmd/notion@latestDownload from GitHub Releases.
Available for:
- macOS: Intel & Apple Silicon (tar.gz)
- Linux: amd64 & arm64 (tar.gz)
- Windows: amd64 & arm64 (zip)
- Create an integration at https://www.notion.so/my-integrations
- Set your token:
export NOTION_TOKEN=<your-token># Or save to keyring:
notion auth add default <your-token>- Share pages/databases with your integration in Notion
notion pages list # list all pages
notion pages list --database=<id># list from database
notion pages list -f Status -f Priority # show properties inline
notion pages get <id-or-url># get page details
notion pages create --parent=<id> --title="New Page"
notion pages update <id> --set="Status=Done"# smart type detection
notion pages archive <id>echo"# Hello"| notion pages append-md <id># append markdown
notion pages export-md <id-or-url># export as markdownnotion databases list # list all databases
notion databases get <id># get schema
notion databases query <id># query pages
notion databases query <id> -w "Status.equals(Done)"# with filternotion blocks list <page-id># list blocks
notion blocks get <block-id># get block
notion blocks delete <block-id># delete blocknotion search "meeting notes"# search workspace
notion search "project" --json # JSON outputnotion users list # list workspace users
notion users me # current user# Process JSONL from stdin
cat operations.jsonl | notion batchnotion pages list # table (default)
notion pages list --json # JSON for scripts/agents
notion pages list --plain # TSV for piping| Environment Variable | Description | Default |
|---|---|---|
NOTION_TOKEN | API token | - |
NOTION_PROFILE | Auth profile name | default |
NO_COLOR | Disable colored output | - |
This CLI wraps the Notion API for terminal and agent use. Features include:
- URL support: Use Notion URLs or IDs interchangeably
- Smart updates: Auto-detects property types for
--setflag - Parallel fetching: Fast markdown export with concurrent API calls
- Rate limiting: Built-in respect for Notion's API limits
- Auth profiles: Store multiple tokens in system keyring
No affiliation with Notion Labs, Inc.
MIT