ntn
Official Notion CLI — API access and Workers from the terminal
Description
ntn is Notion's official command-line interface. It brings the full Notion API to your terminal and provides tools for building, deploying, and managing Notion Workers. Designed for both humans and AI agents, it enables direct interaction with Notion data sources, pages, and the developer platform without needing a browser or complex setup.
When to use this tool
- You want to interact with Notion data from scripts or the terminal
- You're building or deploying Notion Workers
- You need a lightweight way to use the Notion API without writing full programs
- You're working with AI agents that need Notion integration
- You need a graphical interface
- You're on Windows (not currently supported)
Install
curl -fsSL https://ntn.dev | bashAI Summary
Official Notion CLI for accessing the Notion API and managing Workers directly from the terminal. Built for humans and AI coding agents.
Capabilities
- + Full access to the Notion API from the command line
- + Create, query, and manage pages and data sources
- + Build and deploy Notion Workers
- + Login and authenticate with Notion workspaces
- + Direct API calls via `ntn api`
Use When
- → You want to interact with Notion data from scripts or the terminal
- → You're building or deploying Notion Workers
- → You need a lightweight way to use the Notion API without writing full programs
- → You're working with AI agents that need Notion integration
Avoid When
- x You need a graphical interface
- x You're on Windows (not currently supported)
Usage Patterns
Login to Notion
ntn loginAuthenticate with your Notion workspace
Create a new Worker
ntn workers newScaffold a new Notion Worker project
Query a data source
ntn datasources queryQuery data from a Notion database
Create a page from Markdown
ntn pages createCreate a new page using Markdown content
Call the Notion API directly
ntn apiMake raw API calls to Notion