AgentSkillsCN

Notion CLI

通过 Notion CLI 与 Notion 工作空间交互。适用于搜索页面、阅读页面内容、查询数据库、创建页面，或更新属性时使用。所有操作均通过 Notion CLI 二进制文件完成。

SKILL.md
--- frontmatter
name: Notion CLI
description: >
  Interact with Notion workspaces via the notion CLI. Use when searching
  pages, reading page content, querying databases, creating pages, or
  updating properties. All operations go through the notion CLI binary.

Notion CLI

A command-line interface for the Notion API, provided by the notion-cli project. This skill enables an AI agent to interact with Notion workspaces — searching pages, reading content, creating pages, and updating databases — entirely from the terminal.

Purpose

Use this skill when an agent needs to:

  • •Search for pages or databases in a Notion workspace
  • •Read page content or database entries
  • •Create new pages or database items
  • •Update existing page properties

All operations go through the notion CLI binary. The agent must never call the Notion API directly.

Installation

macOS

  1. •

    Install via Homebrew:

    code
    brew install salmonumbrella/tap/notion-cli
  2. •

    Verify:

    code
    notion --version

Linux

  1. •

    Install Node.js 16+ via your package manager or nvm.

  2. •

    Install the CLI globally:

    code
    npm install -g notion-cli
  3. •

    Verify:

    code
    notion --version

For the latest installation instructions, see the notion-cli README.

Configuration

Before first use, configure your Notion integration token:

code
notion config set token <YOUR_NOTION_INTEGRATION_TOKEN>

Alternatively, export the token as an environment variable:

code
export NOTION_TOKEN=<YOUR_NOTION_INTEGRATION_TOKEN>

To create a Notion integration token:

  1. •Visit https://www.notion.so/my-integrations
  2. •Create a new internal integration
  3. •Copy the token
  4. •Share the target pages/databases with the integration

Verify Commands

These non-destructive commands confirm the CLI is installed and configured:

code
notion --version
notion --help

Usage Examples

Search for pages

code
notion search --query "Meeting Notes"

Read a page

code
notion page get <PAGE_ID>

List database entries

code
notion database query <DATABASE_ID>

Create a page

code
notion page create --parent <PAGE_ID> --title "New Page"

Update a database entry

code
notion page update <PAGE_ID> --property "Status" --value "Done"

Output parsing

The CLI outputs JSON by default. Parse output programmatically — do not regex-match or string-split results. Check the exit code to determine success (0) or failure (non-zero).

Command Schemas

See references/commands.json for structured command definitions with parameter schemas, exit codes, and examples.

Security Notes

  • •Token handling: The Notion integration token grants read/write access to shared pages. Store it in an environment variable or the CLI config file — never hard-code it in scripts or logs.
  • •Config file: Located at ~/.notion-cli/config.json. Set permissions to 600 (chmod 600 ~/.notion-cli/config.json).
  • •Minimum scope: Only share the specific pages and databases the agent needs with the integration. Do not share the entire workspace.
  • •Audit: Review integration activity in Notion's audit log periodically.