How do I install the Notion CLI skill?

Run npx skillmds@latest add javimosch/notion-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Notion CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Notion CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Notion CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Notion CLI?

javimosch (@javimosch) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Notion CLI by javimosch — Agent Skill

Name: Notion CLI
Author: javimosch

Notion CLI

Use this skill when the user wants to search, create, read, or manage Notion pages and databases — search workspace, query databases, create pages, read/write page content as Markdown, manage blocks, users, and files.

javimosch 1480f3d 2.8 KB Updated Sep 17, 2026

File contents

Notion CLI Plugin

Like gh for GitHub, but for Notion. 39 commands. One binary. Full Notion API coverage.

Prerequisites

Requires a Notion API token (Integration token). Create one at https://www.notion.so/profile/integrations

# Authenticate
echo "ntn_xxxxx" | notion auth login --with-token
# or
export NOTION_TOKEN=ntn_xxxxx

Commands

Auth

notion auth status — Check authentication status

Search

notion search run "query" — Search pages and databases

Databases

notion db list — List databases
notion db query <dbId> --filter 'Status=Done' --sort 'Date:desc' — Query with filters

Blocks (Content)

notion block list <pageId> --md --depth 3 — Read page as Markdown
notion block append <pageId> --file document.md — Append Markdown content

Users

notion user list — List workspace members

API

notion api request GET /v1/users/me — Raw Notion API request

Full Access

notion _ _ — Passthrough for any notion command (comment, file, block insert/update, etc.)

Usage Examples

"Search my Notion for meeting notes"
"Show me the content of that Notion page as Markdown"
"Create a new page in my Tasks database with status Todo"
"Query the Projects database for items with Status = Done"
"List all my Notion databases"
"Append notes.md to my Weekly Review page"

Installation

The recommended install is with go install. The resulting binary is named notion-cli, so symlink or rename it to notion before running any commands:

go install github.com/4ier/notion-cli@latest
GOBIN=$(go env GOBIN); GOPATH=$(go env GOPATH); ln -sf "${GOBIN:-$GOPATH/bin}/notion-cli" "${GOBIN:-$GOPATH/bin}/notion"

Or install with Homebrew:

brew install 4ier/tap/notion-cli

Or install with npm:

npm install -g @4ier/notion-cli

Or download a binary from GitHub Releases.

Key Features

Agent-friendly: JSON output auto-detected when piped, schema-aware, URL or ID support
Full API coverage: 39 subcommands across pages, databases, blocks, comments, users, files
Human-friendly filters: --filter 'Status=Done' — no JSON needed for 90% of queries
Markdown I/O: Read pages as Markdown, write Markdown to pages
Smart output: Colored tables in terminal, clean JSON when piped
Single Go binary: No runtime dependencies

---name: notion-clidescription: Use this skill when the user wants to search, create, read, or manage Notion pages and databases — search workspace, query databases, create pages, read/write page content as Markdown, manage blocks, users, and files.---# Notion CLI PluginLike `gh` for GitHub, but for Notion. 39 commands. One binary. Full Notion API coverage.## PrerequisitesRequires a Notion API token (Integration token). Create one at https://www.notion.so/profile/integrations```bash# Authenticateecho "ntn_xxxxx" | notion auth login --with-token# orexport NOTION_TOKEN=ntn_xxxxx```## Commands### Auth- `notion auth status` — Check authentication status### Search- `notion search run "query"` — Search pages and databases### Pages- `notion page view <pageId>` — View page details- `notion page list` — List recent pages- `notion page create <dbId> --db "Name=Task" "Status=Todo"` — Create page in database### Databases- `notion db list` — List databases- `notion db query <dbId> --filter 'Status=Done' --sort 'Date:desc'` — Query with filters### Blocks (Content)- `notion block list <pageId> --md --depth 3` — Read page as Markdown- `notion block append <pageId> --file document.md` — Append Markdown content### Users- `notion user list` — List workspace members### API- `notion api request GET /v1/users/me` — Raw Notion API request### Full Access- `notion _ _` — Passthrough for any notion command (comment, file, block insert/update, etc.)## Usage Examples- "Search my Notion for meeting notes"- "Show me the content of that Notion page as Markdown"- "Create a new page in my Tasks database with status Todo"- "Query the Projects database for items with Status = Done"- "List all my Notion databases"- "Append notes.md to my Weekly Review page"## InstallationThe recommended install is with `go install`. The resulting binary is named `notion-cli`, so symlink or rename it to `notion` before running any commands:```bashgo install github.com/4ier/notion-cli@latestGOBIN=$(go env GOBIN); GOPATH=$(go env GOPATH); ln -sf "${GOBIN:-$GOPATH/bin}/notion-cli" "${GOBIN:-$GOPATH/bin}/notion"```Or install with Homebrew:```bashbrew install 4ier/tap/notion-cli```Or install with npm:```bashnpm install -g @4ier/notion-cli```Or download a binary from [GitHub Releases](https://github.com/4ier/notion-cli/releases).## Key Features- **Agent-friendly**: JSON output auto-detected when piped, schema-aware, URL or ID support- **Full API coverage**: 39 subcommands across pages, databases, blocks, comments, users, files- **Human-friendly filters**: `--filter 'Status=Done'` — no JSON needed for 90% of queries- **Markdown I/O**: Read pages as Markdown, write Markdown to pages- **Smart output**: Colored tables in terminal, clean JSON when piped- **Single Go binary**: No runtime dependencies

Frequently asked questions