notion - SKILL.md Agent Skill

name: notion description: Manage Notion pages, databases, and comments from the command line. Search, view, create, and edit content in your Notion workspace. allowed-tools: Bash(notion-cli:*)

Notion CLI

Manage Notion from the command line via notion-cli.

Commands

notion-cli search <query>                    # Search the workspace
notion-cli page list                         # List pages
notion-cli page view <page>                  # View a page (renders as markdown)
notion-cli page create --title "Title"       # Create a page
notion-cli page edit <page> --replace "..."  # Edit a page
notion-cli page upload ./file.md             # Upload a markdown file
notion-cli db list                           # List databases
notion-cli db query <database>               # Query a database
notion-cli comment list <page>               # List comments
notion-cli comment create <page> --content "..."  # Add a comment

All page commands accept a URL, name, or ID to identify pages.

Common Operations

Search first, then operate

notion-cli search "meeting notes" --json
notion-cli page view "Engineering Roadmap"

Creating pages

notion-cli page create --title "New Doc" --content "# Heading\n\nContent"
notion-cli page create --title "Child" --parent "Engineering"

Editing pages

notion-cli page edit <page> --replace "New content"
notion-cli page edit <page> --find "old text" --replace-with "new text"
notion-cli page edit <page> --find "section" --append "additional content"

Output Formats

Most commands support --json for machine-readable output and --raw for original Notion markup.

Use --help on any command for full options.