notion-cli-tool 0.1.0

# notion-cli

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

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

```bash
$ 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)

```bash
cargo install notion-cli-tool
```

### From source

```bash
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](https://www.notion.so/my-integrations)

## Quick Start

### 1. Get your API key

1. Go to [Notion Integrations](https://www.notion.so/my-integrations)
2. Click "New integration"
3. Copy the "Internal Integration Token"
4. **Important**: Share your pages with the integration!

### 2. Configure

```bash
# 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

```bash
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`

```bash
# View current config
notion-cli config

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

## Usage

### Search

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

### Read

```bash
notion-cli read <page_id>
```

### Create

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

### Append Content

```bash
# 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

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

### Delete

```bash
notion-cli delete <page_id>  # Moves to trash
```

### Query Database

```bash
# 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

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

### Other Commands

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

### Global Options

```bash
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](LICENSE) for details.

---