# ntn
> Official Notion CLI — API access and Workers from the terminal

## 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`

## When to Use
- 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

## When NOT to Use
- You need a graphical interface
- You're on Windows (not currently supported)

## Usage Patterns
### Login to Notion
```
ntn login
```
Authenticate with your Notion workspace

### Create a new Worker
```
ntn workers new
```
Scaffold a new Notion Worker project

### Query a data source
```
ntn datasources query
```
Query data from a Notion database

### Create a page from Markdown
```
ntn pages create
```
Create a new page using Markdown content

### Call the Notion API directly
```
ntn api
```
Make raw API calls to Notion

## Installation
- **shell**: `curl -fsSL https://ntn.dev | bash`

---
Source: https://littlescripts.sh/tools/ntn