---
name: notion-cli
description: The CLI is self-documenting. Always prefer running these commands over guessing syntax or relying on memorized knowledge:
---

# notion-cli

The CLI is self-documenting. Always prefer running these commands over guessing syntax or relying on memorized knowledge:

# notion-cliby notion
The CLI is self-documenting. Always prefer running these commands over guessing syntax or relying on memorized knowledge:

`npx skills add https://github.com/makenotion/skills --skill notion-cli`Download ZIPGitHub

## Notion CLI

## Look things up before answering

The CLI is self-documenting. Always prefer running these commands over guessing
syntax or relying on memorized knowledge:

* `ntn api ls` — list every public API endpoint.

* `ntn api <path> --help` — show methods, doc links, and usage for an endpoint.

* `ntn api <path> --docs` — print the full official docs for an endpoint.

* `ntn api <path> --spec` — print a reduced OpenAPI fragment (useful for
understanding request/response schemas).

* `ntn pages get <page-id>` — retrieve a page as Markdown. Use this to read page
content.

* `ntn <command> --help` — help for any command or subcommand.

## Install

```
`curl -fsSL https://ntn.dev | bash
`
```

## Authentication

* The CLI automatically uses `NOTION_API_TOKEN` when it is set.

* Check `NOTION_API_TOKEN` first. If it is already set, prefer using it instead
of telling the user to run `ntn login`.

* `ntn login` / `ntn logout` — log the CLI in or out (only use if not using
`NOTION_API_TOKEN`). `ntn login` requires the user to visit a URL in a web
browser.

## `ntn api`

Run `ntn api --help` for full syntax. Quick summary:

```
`# GET with query param
ntn api v1/users page_size==100

# POST with inline body fields
ntn api v1/pages parent[page_id]=abc123

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

The method is inferred (GET by default, POST when a body is present). Override
with `-X METHOD`.

### Markdown for pages and comments

Prefer `ntn pages create` / `ntn pages update` for Markdown page content. Use
the `markdown` field when creating or updating comments via `ntn api`.

```
`# Comment with markdown
ntn api v1/comments -d '{"parent":{"page_id":"abc123"},"markdown":"Here is a [link](https://example.com) and **bold text**."}'

# Page with markdown body
ntn pages create --parent page:abc123 --content '## Heading\n\nSome *formatted* content.'
`
```

The `markdown` field supports inline formatting (bold, italic, code, links, etc.).
Only fall back to `rich_text` if you need features that Markdown cannot express (e.g. mentions, custom emoji, or colors).

## `ntn files`

Convenience wrapper around the File Uploads API.

```
`ntn files create < image.png
ntn files create --external-url https://example.com/photo.png
ntn files list
ntn files get <upload-id>
`
```

## `ntn workers`

Manage Notion workers (deploy, list, execute, etc.). Run `ntn workers --help`
for subcommands.

```
`ntn workers new my-worker # scaffold a new project
ntn workers deploy # deploy from current directory
ntn workers ls # list workers
ntn workers exec <capability> # execute a capability
`
```

## More skills from notion
notion-knowledge-captureby notionTransforms conversations and discussions into structured documentation pages in Notion. Captures insights, decisions, and knowledge from chat context, formats…notion-meeting-intelligenceby notionPrepares meeting materials by gathering context from Notion, enriching with Claude research, and creating both an internal pre-read and external agenda saved…notion-research-documentationby notionSearches across your Notion workspace, synthesizes findings from multiple pages, and creates comprehensive research documentation saved as new Notion pages.…notion-spec-to-implementationby notionTurns product or tech specs into concrete Notion tasks that Claude code can implement. Breaks down spec pages into detailed implementation plans with clear…create-database-rowby notionInsert a new row into a specified Notion database using natural-language property values. Handles property name matching and validation.create-pageby notionCreate a new Notion page, optionally under a specific parent. Automatically structures content based on page type (meeting notes, project pages, etc.).create-taskby notionCreate a new task in the user's Notion tasks database with sensible defaults for due date, status, owner, and project.database-queryby notionQuery a Notion database by name or ID and return structured, readable results with optional filters and sorting.

---

**Source**: https://github.com/makenotion/skills/tree/HEAD/skills/notion-cli
**Author**: notion
**Discovered via**: mcpservers.org