# 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 ```sh sudo av install cask:notion-cli ``` Additional install commands: ### macOS - Homebrew Cask (100%): ```sh brew install --cask notion-cli ``` Evidence: local Homebrew cask metadata ## Package facts - **Package key:** cask:notion-cli - **Package manager:** Homebrew Cask - **Version:** 0.21.7 - **Source summary:** Command-line interface for Notion - **Homepage:** - **Last updated:** 2026-08-01T05:07:40Z - **Generated:** 2026-08-03T19:37:03+00:00 ## Executables - ntn (binary) - ntn (alias) ## Install behavior - Bottle: not available ## Freshness - Page generated: 2026-08-03 - Package-manager version: 0.21.7 ## 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 Notes 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. ## 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 - Unix: workers.json, $NOTION_HOME/config.json, $XDG_CONFIG_HOME/notion/config.json, ~/.config/notion/config.json, ~/.notion/config.json ## Credential files - Unix: $NOTION_HOME/auth.json, $XDG_CONFIG_HOME/notion/auth.json, ~/.config/notion/auth.json, ~/.notion/auth.json ## Other Package-Manager Records - winget - Notion.ntn: installed executable or alias match | Windows Package Manager source index: Notion.ntn from https://cdn.winget.microsoft.com/cache/source.msix ## Combined YAML source View the package source record on GitHub. [combined/notion-cli.yml](https://github.com/mxcl/pkgdb/blob/main/combined/notion-cli.yml) ## Sources - pkg.so package database - curated configuration and credential file locations - curated package history - pkgdb category and tag curation - external package-manager database matches - cross-ecosystem install command graph