macOS
Homebrew Caskverified · 100%
brew install --cask notion-clilocal Homebrew cask metadata
cask / rank 1714
Install notion-cli with Homebrew Cask
Command-line interface for Notion. Version 0.21.7 via Homebrew Cask; verified 2026-08-01. Also installable with winget: winget install --id Notion.ntn -e.
install
Additional install commands
overview
Package summary
Command-line interface for Notion
Project links
Commands and aliases
- ntn
history
Project history and usage
Notion CLI, installed as `ntn`, is Notion's official developer command-line tool for authenticating to a workspace, managing Notion Workers, making authenticated Notion API requests, and uploading files.
Project history
The official Notion CLI docs introduce `ntn` as the Notion CLI and document script, npm, Winget, and source-build installation paths. The official installation page points developers to the `makenotion/cli` GitHub repository for building from source.
Adoption history
The Homebrew cask packages Notion CLI 0.18.1 from ntn.dev release archives and installs the `ntn` binary. Homebrew cask analytics in July 2026 report 571 installs over both 90 and 365 days, suggesting early but active package-manager adoption for Notion's developer platform.
How it is used
Users install `ntn`, verify with `ntn --version`, authenticate with `ntn login`, then run workflows such as `ntn workers new`, `ntn workers deploy`, `ntn api v1/users`, and `ntn files create`. The command reference documents environment overrides including `NOTION_API_TOKEN`, `NOTION_WORKSPACE_ID`, `NOTION_KEYRING`, `NOTION_HOME`, and `NOTION_WORKERS_CONFIG_FILE`.
Why package nerds care
Notion CLI is notable as a modern vendor CLI distributed across shell installer, npm, Winget, source builds, and Homebrew cask, with local keychain-backed auth and project-level Worker config.
Timeline
- 2026: Homebrew cask metadata packages Notion CLI 0.18.1.
- 2026-07: Homebrew cask API reports 571 installs over 365 days.
Related projects
- Notion API, Notion Workers, Notion MCP, npm package ntn, Winget package Notion.ntn
Sources
security posture
No protected-tool coverage found yet
No matching local secret-handling manifest was found for notion-cli. Nucleus package metadata is still published here so future coverage has a stable package URL.
Install behavior
- No Homebrew bottle metadata was recorded.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Configuration files
Config paths the tool may read or write during local use.
- Unix
workers.json$NOTION_HOME/config.json$XDG_CONFIG_HOME/notion/config.json~/.config/notion/config.json~/.notion/config.json
Credential files
Credential-bearing paths to review before unattended agent runs.
- Unix
$NOTION_HOME/auth.json$XDG_CONFIG_HOME/notion/auth.json~/.config/notion/auth.json~/.notion/auth.json
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
ntn | binary | Homebrew cask binary | ntn-aarch64-apple-darwin/ntn |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-08-03
manager version0.21.7
manager updated2026-08-01
local dataunknown
upstreamnot available
latest detectednot detected
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | cask:notion-cli |
|---|---|
| Version | 0.21.7 |
| Package manager | Homebrew Cask |
| Homepage | https://www.notion.com/product/dev |
| Last updated | 2026-08-01T05:07:40Z |
| Pulse | updated |
| SHA-256 | 215380e8be24e1ba8c9be5d2a89ebed0bd6baf3e1de1876227d14017382df947 |
| Download URL | https://ntn.dev/releases/v0.21.7/ntn-aarch64-apple-darwin.tar.gz |
| Bottle | not recorded |
| Service | none declared |
source database matches
Other package-manager records
Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.
winget92%
Notion.ntn
winget install --id Notion.ntn -e- installed executable or alias match
- Matched by: Ntn
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- external package-manager database matches
- pkg.so package database
- pkgdb category and tag curation