🔖 raindrop-cli - Raindrop in your terminal

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

Agent Skill

This CLI is available as an open agent skill for AI assistants including Claude Code, OpenClaw, Codex, Cursor, GitHub Copilot, and 35+ agents.

npx skills add dedene/raindrop-cli

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

# Basheval"$(raindrop completion bash)"# Zsheval"$(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