Installation

Install via script (recommended)

The recommended way to install ntn on macOS and Linux:

curl -fsSL https://ntn.dev | bash

To inspect the installer before running it, view the install script. To update:

ntn update

Install via npm

Use macOS, Linux, or Windows to install:

npm install --global ntn

To update:

npm update --global ntn

Requires Node.js 22+ and npm 10+.

Install via Winget (Windows)

In PowerShell or Command Prompt, including either shell in Windows Terminal:

winget install Notion.ntn

You can also confirm the WinGet package:

winget list --exact --id Notion.ntn

Restart your terminal to verify. To update:

winget upgrade Notion.ntn

We currently only support Windows x64 (x86-64/AMD64)

Verify installation

ntn --version

Shell completions

Enable tab completions for your shell:

ntn completions bash  # or fish, zsh, powershell, elvish

Building from source

Clone the repository and use mise to build a local debug binary installed as ntnd:

git clone https://github.com/makenotion/cli.git
cd cli
mise build

See the CLI README for mise watch and other development workflows.

Next steps

Authentication

Workers quickstart

Create and deploy your first Notion Worker.

Get started

Guides

Reference

Install via script (recommended)

Install via npm

Install via Winget (Windows)

Verify installation

Shell completions

Building from source

Next steps

Authentication

Workers quickstart

​Install via script (recommended)

​Install via npm

​Install via Winget (Windows)

​Verify installation

​Shell completions

​Building from source

​Next steps

Authentication

Workers quickstart

Install via script (recommended)

Install via npm

Install via Winget (Windows)

Verify installation

Shell completions

Building from source

Next steps