notion-cli

A fast and simple Notion CLI written in Rust. Manage your Notion pages and databases from the terminal.

$ notion-cli search "meeting notes"
✓ 3 results found

  • [page] Weekly Team Meeting
    ID: abc123...

  • [page] 1:1 Meeting Notes  
    ID: def456...

Features

• 🔍 Search - Find pages and databases instantly
• 📖 Read - View page content with syntax highlighting
• ✏️ Create - Create new pages with content
• 📝 Append - Add text, code blocks, headings, lists, bookmarks
• 🔄 Update - Modify titles and icons
• 🗃️ Query - Filter and sort database entries
• 📦 Move - Relocate pages to different parents
• ⚡ Fast - Written in Rust, minimal overhead
• 🔄 Auto-retry - Handles rate limits automatically

Installation

From crates.io (Recommended)

cargo install notion-cli-tool

From source

git clone https://github.com/demarlik01-ai/notion-cli-rs.git
cd notion-cli-rs
cargo install --path .

Requirements

• Rust 1.70+ (for building from source)
• Notion Integration Token

Quick Start

1. Get your API key

1. Go to Notion Integrations
2. Click "New integration"
3. Copy the "Internal Integration Token"
4. Important: Share your pages with the integration!

2. Configure

# Interactive setup (recommended)
notion-cli init

# Or set environment variable
export NOTION_API_KEY=secret_xxxxx

# Or create config file manually
echo 'api_key = "secret_xxxxx"' > ~/.config/notion-cli/config.toml

3. Start using

notion-cli search "my project"
notion-cli read <page_id>
notion-cli create --parent <page_id> --title "New Page"

Configuration

API key is resolved in this order:

1. --api-key command line option
2. NOTION_API_KEY environment variable
3. ~/.config/notion-cli/config.toml

# View current config
notion-cli config

# Update config
notion-cli init --api-key "secret_new_key"

Usage

Search

notion-cli search "query"
notion-cli search "project" --limit 10

Read

notion-cli read <page_id>

Create

notion-cli create --parent <parent_id> --title "Page Title"
notion-cli create --parent <parent_id> --title "Page Title" --content "First paragraph"

Append Content

# Text
notion-cli append <page_id> "New paragraph"

# Code block
notion-cli append-code <page_id> "console.log('hello')" --language javascript

# Heading
notion-cli append-heading <page_id> "Section Title" --level 2

# Bulleted list
notion-cli append-list <page_id> "Item 1,Item 2,Item 3"

# Bookmark
notion-cli append-bookmark <page_id> "https://example.com"

# Divider
notion-cli append-divider <page_id>

Update

notion-cli update <page_id> --title "New Title"
notion-cli update <page_id> --icon "🚀"
notion-cli update <page_id> --title "New Title" --icon "📝"

Delete

notion-cli delete <page_id>  # Moves to trash

Query Database

# All entries
notion-cli query <database_id>

# With filter
notion-cli query <database_id> --filter "Status=Done"
notion-cli query <database_id> --filter "Priority:select=High"

# With sort
notion-cli query <database_id> --sort "Created" --direction desc

# Limit results
notion-cli query <database_id> --limit 20

Filter format: PropertyName=value or PropertyName:type=value

Supported types: title, rich_text, select, checkbox, number

Move Page

notion-cli move <page_id> --parent <new_parent_id>
notion-cli move <page_id> --parent <new_parent_id> --delete  # Archive original

Other Commands

notion-cli get-block-ids <page_id>    # List all block IDs
notion-cli delete-block <block_id>    # Delete a specific block

Global Options

notion-cli --api-key <key> <command>  # Override API key
notion-cli --timeout 60 <command>     # Custom timeout (default: 30s)
notion-cli --help                     # Show help
notion-cli --version                  # Show version

API Version

Uses Notion API 2025-09-03 (latest).

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

MIT License - see LICENSE for details.