Office & Productivity
Notion

Notion CLI

Pages, databases and blocks via Notion REST API

✓ 13 tests passed
Install
$ pip install cli-anything-notion
About

Full programmatic control over Notion workspaces. Create and update pages, append blocks, query databases with filters, search across workspace — all via official Notion REST API v1.

Knowledge BaseDatabase QueryREST API
Requirements
NOTION_TOKEN (Integration token)
Command Reference
Command Arguments Description
detect Verify Notion integration token
version Show API version and user info
search QUERY --limit N Search pages and databases
page get PAGE_ID Get page content
page create --parent-id ID --title TITLE Create page
page append-text PAGE_ID TEXT Append text block to page
page archive PAGE_ID Archive page
database query DB_ID --filter JSON --limit N Query database
users list List workspace members
Usage Examples
# Install
$ pip install cli-anything-notion

# Health check
$ notion-cli detect

# Get capabilities schema (Agent-ready, no token needed)
$ notion-cli schema

# Run with JSON output (for AI Agent integration)
$ notion-cli --json detect

# Example JSON response:
{"id":"abc-123","title":"My Page","created":"2026-03-15","blocks":8}
Agent Integration
# Python — call from AI Agent
import subprocess, json

result = subprocess.run(
    ["notion-cli", "--json", "detect"],
    capture_output=True, text=True
)
data = json.loads(result.stdout)
print(data)

# Discover all commands without credentials:
schema = subprocess.run(
    ["notion-cli", "schema"],
    capture_output=True, text=True
)
capabilities = json.loads(schema.stdout)