Agent Skills › composio-community/awesome-agent-clis › Notion CLI (ntn)

Notion CLI (ntn)

GitHub

Notion官方CLI工具，用于身份认证、API交互、文件上传及Workers管理。支持页面创建查询、数据库操作和Worker部署，适用于自动化处理Notion内容或集成工作流。

ntn/SKILL.md composio-community/awesome-agent-clis

Trigger Scenarios

需要与Notion API进行交互在终端中管理Notion页面或数据库上传文件到Notion 部署或管理Notion Workers

Install

npx skills add composio-community/awesome-agent-clis --skill Notion CLI (ntn) -g -y

More Options

Non-standard path

npx skills add https://github.com/composio-community/awesome-agent-clis/tree/master/ntn -g -y

Use without installing

npx skills use composio-community/awesome-agent-clis@Notion CLI (ntn)

指定 Agent (Claude Code)

npx skills add composio-community/awesome-agent-clis --skill Notion CLI (ntn) -a claude-code -g -y

安装 repo 全部 skill

npx skills add composio-community/awesome-agent-clis --all -g -y

预览 repo 内 skill

npx skills add composio-community/awesome-agent-clis --list

SKILL.md

Frontmatter

{
    "name": "Notion CLI (ntn)",
    "description": "CLI for Notion — authenticate, manage Workers, interact with the Notion API, and upload files. Use when an agent needs to create or query Notion pages, manage databases, upload files to Notion, or deploy Notion Workers."
}

ntn — The Notion CLI

Official Notion CLI for authentication, Workers management, and API access.

Package: https://www.npmjs.com/package/ntn
Author: Notion (@makenotion)

Installation

npm i -g ntn

Authentication

ntn login
ntn logout

Key Commands

Notion API

Access the full public Notion API from the terminal. Requires a Notion integration token via NOTION_API_TOKEN.

# List available API endpoints
ntn api ls

# View endpoint spec or docs
ntn api v1/pages --spec -X POST
ntn api v1/pages --docs -X POST

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

# Query with typed JSON
ntn api v1/pages archived:=true properties[count]:=10

# Query params and headers
ntn api v1/users page_size==100 Accept:application/json

Inline Request Syntax

# Direct JSON body
ntn api v1/pages -d '{"parent":{"page_id":"abc123"}}'

# String assignment
ntn api v1/pages parent[page_id]=abc123

# Typed JSON assignment
ntn api v1/pages archived:=true properties[count]:=10

# Query params
ntn api v1/users page_size==100

# Headers
ntn api v1/users Accept:application/json

Method selection:

GET by default
POST automatically when body fields are present
-X/--method overrides

File Uploads

# Upload a file from stdin
ntn files create < file.png

# Upload from URL
ntn files create --external-url https://example.com/photo.png

# List and inspect uploads
ntn files list
ntn files get <upload-id>

Workers

ntn workers --help
ntn workers list
ntn workers deploy

Environment Variables

NOTION_API_TOKEN: Notion integration token (required for ntn api and ntn files commands)

Notes

ntn files create is intentionally quiet on success — shows a progress bar only when stderr is a TTY
Shell completion can suggest API paths and supported methods
Currently in alpha — focused on Workers development workflows