🔖 raindrop-cli - Raindrop in your terminal

A command-line interface for Raindrop.io bookmark management.

Installation

Homebrew

brew install dedene/tap/raindrop

From source

go install github.com/dedene/raindrop-cli/cmd/raindrop@latest

From releases

Download the latest binary from releases.

Authentication

Test token (personal use)

Get a test token from raindrop.io/settings/integrations:

raindrop auth token <your-token>
raindrop auth status

Or use environment variable:

export RAINDROP_TOKEN=<your-token>

OAuth2 (apps/shared use)

1. Create an app at raindrop.io/app.
2. Set the redirect URI to http://localhost:8484/callback (or update oauth_port in config).
3. Save credentials:

raindrop auth setup <client_id>

4. Authenticate:

raindrop auth login

Quick Start

# Add a bookmark
raindrop add https://example.com
raindrop add https://example.com --collection Work --tags "reference,docs"

# List bookmarks
raindrop list
raindrop list --favorites
raindrop list Work --all

# Search
raindrop search "golang"
raindrop search --tag programming --type article

# Get details
raindrop get 12345

# Update
raindrop update 12345 --title "New Title" --tags "updated"

# Delete
raindrop delete 12345

Commands

Core

Command	Description
add [url]	Add a bookmark
list [collection]	List bookmarks
get <id>	Get bookmark details
update <id>	Update a bookmark
delete <id>	Delete a bookmark
search [query]	Search bookmarks

Collections

Command	Description
collections list	List collections (tree view)
collections get <name>	Get collection details
collections create <name>	Create a collection
collections update <name>	Update a collection
collections delete <name>	Delete a collection

Tags

Command	Description
tags list	List all tags
tags rename <old> <new>	Rename a tag
tags merge <tags> --into <target>	Merge tags
tags delete <tags>	Delete tags

Highlights

Command	Description
highlights list <id>	List highlights
highlights add <id> <text>	Add a highlight
highlights delete <id> <highlight-id>	Delete a highlight

Utility

Command	Description
import <file>	Import Netscape HTML bookmarks
export --format csv|html|zip	Export bookmarks
open <id>	Open in browser
copy <id>	Copy URL to clipboard

Flags

Flag	Description
--json	Output JSON
--force	Skip confirmations
--no-input	CI mode (fail on prompts)
--verbose	Verbose output

Shell Completions

# Bash
eval "$(raindrop completion bash)"

# Zsh
eval "$(raindrop completion zsh)"

# Fish
raindrop completion fish > ~/.config/fish/completions/raindrop.fish

Configuration

Config file: ~/.config/raindrop-cli/config.yaml

raindrop config path
raindrop config get <key>
raindrop config set <key> <value>

System Collections

Name	ID	Description
all	0	All raindrops
unsorted	-1	Unsorted
trash	-99	Trash

Collection names are case-insensitive: raindrop list Work or raindrop list work.

Bulk Operations

Add multiple URLs from stdin:

echo -e "https://a.com\nhttps://b.com" | raindrop add -

License

MIT