Notion CLI

Notion CLI (ntn) is Notion’s terminal client for authenticating with a workspace, making API requests, and deploying and managing Notion Workers. This Homebrew package installs a command-line executable, not the Notion desktop application.

Terminal workflows

Use ntn api to make authenticated Notion API requests with inline JSON construction and shell completion. The official overview demonstrates retrieving users, creating pages and patching page properties. The CLI also supports creating, querying and managing data sources, and uploading static assets such as images and PDFs through ntn files.

Notion Workers

Workers are small TypeScript programs that extend Notion with syncs, tools and webhooks. ntn workers new scaffolds a project, ntn workers deploy builds and uploads it, and ntn workers list lists deployed Workers. These hosted capabilities are distinct from the local CLI executable and depend on the workspace’s available platform features.

Installation and authentication

Install the recorded macOS package with brew install --cask notion-cli and check ntn --version. The official ntn login flow opens a browser for workspace authorization and stores credentials in the system keychain. Homebrew distributes separate Apple-silicon and Intel archives. The official installer also supports macOS and Linux and checks a published SHA-256 checksum before installing the binary.

The catalog records version 0.23.19. Its release artifact and official npm metadata establish the version, but an exact-version changelog was not found; no particular feature change is inferred from this build number. No public CLI source-code repository is established by these sources.

Sources

• https://developers.notion.com/cli/get-started/overview
• https://www.notion.com/product/dev
• https://ntn.dev
• https://registry.npmjs.org/ntn/0.23.19
• https://github.com/Homebrew/homebrew-cask/blob/HEAD/Casks/n/notion-cli.rb