Notion Cli

1---2name: notion-cli3description: >-4  Use the Notion CLI (`ntn`) to interact with the Notion API, manage workers,5  and upload files. Use when the user asks to "call the Notion API", "deploy a6  worker", "upload a file to Notion", "create a page", "query a database", or7  any task involving the `ntn` command.8---9 10# Notion CLI11 12## Look things up before answering13 14The CLI is self-documenting. Always prefer running these commands over guessing15syntax or relying on memorized knowledge:16 17- `ntn api ls` — list every public API endpoint.18- `ntn api <path> --help` — show methods, doc links, and usage for an endpoint.19- `ntn api <path> --docs` — print the full official docs for an endpoint.20- `ntn api <path> --spec` — print a reduced OpenAPI fragment (useful for21  understanding request/response schemas).22- `ntn <command> --help` — help for any command or subcommand.23 24## Install25 26```bash27curl -fsSL https://ntn.dev | bash28```29 30## Authentication31 32- The CLI automatically uses `NOTION_API_TOKEN` when it is set.33- Check `NOTION_API_TOKEN` first. If it is already set, prefer using it instead34  of telling the user to run `ntn login`.35- `ntn login` / `ntn logout` — log the CLI in or out (only use if not using36  `NOTION_API_TOKEN`). `ntn login` requires the user to visit a URL in a web37  browser.38 39## `ntn api`40 41Run `ntn api --help` for full syntax. Quick summary:42 43```bash44# GET with query param45ntn api v1/users page_size==10046 47# POST with inline body fields48ntn api v1/pages parent[page_id]=abc12349 50# POST with JSON body51ntn api v1/pages -d '{"parent":{"page_id":"abc123"}}'52```53 54The method is inferred (GET by default, POST when a body is present). Override55with `-X METHOD`.56 57## `ntn files`58 59Convenience wrapper around the File Uploads API.60 61```bash62ntn files create < image.png63ntn files create --external-url https://example.com/photo.png64ntn files list65ntn files get <upload-id>66```67 68## `ntn workers`69 70Manage Notion workers (deploy, list, execute, etc.). Run `ntn workers --help`71for subcommands.72 73```bash74ntn workers new my-worker        # scaffold a new project75ntn workers deploy               # deploy from current directory76ntn workers ls                   # list workers77ntn workers exec <capability>    # execute a capability78```