notion-cli Skill (Notion) for Claude Code: What It Does and How to Install It

Makes Claude use Notion's own ntn command-line tool to call the API, work with pages, upload files and deploy workers.

Installs: 8.9K; on skills.sh
Stars: 179; on GitHub
Files: 1; besides SKILL.md
Updated: Sep 2026; last repo commit

Claude is told to look syntax up in the CLI itself instead of guessing, using ntn api ls, ntn api <path> --help, --docs and --spec, and ntn <command> --help. It then reads pages with ntn pages get, creates or updates pages from Markdown, posts comments, uploads files and manages workers.

You need the ntn CLI, which SKILL.md installs with a curl command piped to bash. It signs in with the NOTION_API_TOKEN variable when that is set, and otherwise with ntn login, which needs you to open a URL in a browser. This is Notion's own repo. For the hosted connection to Notion see the Notion MCP server page.

Good for

Developers who want Claude to call the Notion API from the terminal
People who want pages read as Markdown or created from Markdown
Teams building and deploying Notion workers

Install notion-cli

Claude Code

Copy this prompt.

Install the notion-cli skill in Claude Code. Run this command:

npx skills add makenotion/skills --skill notion-cli

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

The first route installs the skill. The ntn CLI route installs the tool the skill drives, and you need both. After that, sign in with NOTION_API_TOKEN or ntn login. The skill runs a local command, so there is no Claude app upload route.

From the project README. Source.

What's in the skill

When it loads

Use the Notion CLI (`ntn`) to interact with the Notion API, manage workers, and upload files. Use when the user asks to "call the Notion API", "deploy a worker", "upload a file to Notion", "create a page", "query a database", or any task involving the `ntn` command.

Sections in SKILL.md

Look things up before answering
Install
Authentication
ntn api
Markdown for pages and comments
ntn files
ntn workers

Key facts

Author: Notion (vendor's own repo; LICENSE.md names Notion Labs, Inc.)
License: MIT
Installs on skills.sh: 8,894 (Nov 2, 2026)
GitHub stars: 179 for the whole repo (Nov 2, 2026)
Last repo commit: Sep 22, 2026
Audits on skills.sh: Gen Agent Trust Hub: fail, Socket: pass, Snyk: warn
What it includes: 2 files: SKILL.md and LICENSE.md (no scripts)
Needs: The ntn CLI; a NOTION_API_TOKEN or ntn login
Sibling skill: notion-apps in the same repo scaffolds Notion Apps

What it includes

ntn api ls, ntn api <path> --help, --docs and --spec, ntn <command> --help
The CLI documents itself, so Claude is told to run these before answering.
Runs code · Look things up first
Reads a page as Markdown; creates and updates pages from Markdown
Try: “Create a page under my Projects page with this meeting summary”
Runs code · ntn pages get / create / update
Calls any public API endpoint; GET by default, POST when a body is given, -X overrides
Comments use the markdown field. rich_text is for mentions, custom emoji or colors.
Try: “Query my tasks database for items due this week”
Runs code · ntn api
create, list and get for file uploads, from stdin or an external URL
Runs code · ntn files
new, deploy, ls and exec to scaffold, deploy, list and run workers
Runs code · ntn workers
Uses NOTION_API_TOKEN if set; ntn login and ntn logout otherwise
ntn login needs you to open a URL in a web browser.
Runs code · Authentication
SKILL.md lists this as the way to install the CLI
Runs code · Install: curl -fsSL https://ntn.dev | bash

From the official docs

Permissions

Medium risk

Claude can create, change and upload things in the Notion workspace that your token or login reaches. Use a token scoped to the pages it needs and read each command before you approve it.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It can change your Notion workspace
ntn pages create and update, ntn api with a body, ntn files create and ntn workers deploy all write. Use a token that reaches only the pages it needs. github.com
The install pipes a remote script into bash
SKILL.md installs the CLI with curl -fsSL https://ntn.dev | bash. Read the script first if you prefer. github.com
It picks up your NOTION_API_TOKEN
SKILL.md tells Claude to check NOTION_API_TOKEN first and use it when it is set. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	No read-only switch exists.
Talks to	ntn.dev (CLI install script). Notion API (through the ntn CLI)
Sign-in and keys	The ntn CLI reads NOTION_API_TOKEN when it is set; ntn login signs in through a browser.
Scopes	Calls Notion API endpoints with your token or login Creates and updates pages and comments, and uploads files Deploys and executes Notion workers Installs the ntn CLI with a curl command piped to bash

Questions

What does the notion-cli skill do?

It makes Claude use Notion's ntn command-line tool. Claude can call Notion API endpoints, read pages as Markdown, create and update pages, upload files and manage workers.

How do I install it?

Use the install box at the top of this page. The repo README gives the skills CLI command for this skill. You also need the ntn CLI itself, which the box lists as a second step.

Is it official?

It is in the vendor's own repo: makenotion/skills, whose README is titled "Notion Skills", and the skill's LICENSE.md names Notion Labs, Inc. as copyright holder. The ntn CLI install script comes from ntn.dev, which SKILL.md names.

Does it need an API token?

The CLI uses NOTION_API_TOKEN when it is set, and SKILL.md says to prefer it over ntn login. Without a token, ntn login needs you to open a URL in a browser and sign in.

Is it safe?

It can create and change pages, post comments, upload files and deploy workers in the Notion workspace your token or login reaches. The install step pipes a script from ntn.dev into bash. Read the commands Claude proposes before you approve them.

How is it different from the Notion MCP server?

This skill has Claude run the ntn CLI in a terminal. The MCP server is a separate connection that works inside the assistant. See the Notion MCP server page.

Does it work in the Claude app?

No upload route is listed, because the skill runs a local command-line tool. Use it where Claude can run commands, such as Claude Code.

Information

updated Nov 2, 2026

Repository: makenotion/skills
Folder: skills/notion-cli

makenotion/skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3

notion-cli SKILL.md · github.com
makenotion/skills README · github.com
notion-cli LICENSE.md · github.com