notionlisted

# Notion Talk to Notion two ways. Same integration token works for both — pick by what's available. ◆ **`ntn` CLI** — Notion's official CLI. Shorter syntax, one-line file uploads, required for Workers. macOS + Linux only as of May 2026 (Windows support "coming soon"). **Default when installed.** ◆ **HTTP + curl** — works everywhere including Windows. **Default fallback** when `ntn` isn't installed. ## Setup ### 1. Get an integration token (required for both paths) 1. Create an integration at https://notion.so/my-integrations 2. Copy the API key (starts with `ntn_` or `secret_`) 3. Store it as the `NOTION_API_KEY` env var (export it in your shell profile, or keep it in your project/secrets store and source it before use): ``` NOTION_API_KEY=ntn_your_key_here ``` 4. **Share target pages/databases with the integration** in Notion: page menu `...` → `Connect to` → your integration name. Without this, the API returns 404 for that page even though it exists. ### 2. Install `ntn` (preferred path on macOS / Linux) ```bash # Recommended curl -fsSL https://ntn.dev | bash # Or via npm (needs Node 22+, npm 10+) npm install --global ntn ntn --version # verify ``` **Skip `ntn login` — use the integration token instead.** This works headlessly, no browser needed: ```bash export NOTION_API_TOKEN=$NOTION_API_KEY # ntn reads NOTION_API_TOKEN export NOTION_KEYRING=0 # don't try to use the OS keychain ``` Add those exports to your shell profil