# Ntn

> Use this skill when the user wants to interact with the Notion API, upload files to Notion, or manage Notion Workers from the terminal.

- Skill: `javimosch/ntn` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/ntn`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/ntn/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/ntn

---


# ntn — The Notion CLI

Official Notion CLI for API access, Workers management, and file uploads.

## Commands

- `ntn api fetch` — Make Notion API requests
- `ntn files upload` — Upload files to Notion
- `ntn _ _` — Passthrough to ntn CLI

## Installation

```bash
npm i -g ntn
```

## Authentication

```bash
ntn login
# or set NOTION_API_TOKEN
```

## Usage Examples

- "Create a page in Notion"
- "Query a Notion database"
- "Upload a file to Notion"
- "List Notion API endpoints"

## Key Commands

```bash
# List API endpoints
ntn api ls

# Create a page
ntn api v1/pages parent[page_id]=abc123

# Upload a file
ntn files create < file.png

# Inline request syntax
ntn api v1/users page_size==100

# List workers
ntn workers list
```

## Key Features
- **Full API** - Access entire Notion API
- **File Uploads** - Upload files directly
- **Workers** - Deploy & manage Workers
- **Inline Syntax** - Compact request format
- **Official** - Built by Notion