Notion Pages

Search and view content from Notion workspaces using notion-cli.

Prerequisites

Install notion-cli:

go install github.com/lox/notion-cli@latest

Authenticate (first time only - opens browser for OAuth):

notion-cli auth login

Commands

Search

notion-cli search "query"              # Search workspace
notion-cli search "query" --limit 10   # Limit results
notion-cli search "query" --json       # JSON output

View Pages

notion-cli page view <url>             # View page content (markdown)
notion-cli page view <url> --json      # JSON output

List Pages

notion-cli page list                   # List pages
notion-cli page list --limit 50        # Limit results
notion-cli page list --json            # JSON output

Databases

notion-cli db list                     # List databases
notion-cli db query <database-id>      # Query database
notion-cli db query <id> --json        # JSON output

Comments

notion-cli comment list <page-id>      # List comments on a page

Workflow

1. Search for content: Use notion-cli search "topic" to find relevant pages
2. View page content: Use notion-cli page view <url> with a URL from search results
3. Parse JSON for details: Add --json flag when you need structured data

Authentication Status

Check auth status:

notion-cli auth status

Tokens auto-refresh. Manual refresh if needed:

notion-cli auth refresh