dvcrn Raindrop.io Bookmarks
Manage bookmarks via the Raindrop.io API.
Setup
# Get token from: https://app.raindrop.io/settings/integrations → "Create test token"
echo 'RAINDROP_TOKEN="your-token"' > ~/.config/raindrop.env
# Or pass token at runtime (recommended for ephemeral use)
{baseDir}/scripts/raindrop.sh --token "your-token" whoami
Quick Start
# Search bookmarks
{baseDir}/scripts/raindrop.sh search "AI tools"
# List unsorted bookmarks
{baseDir}/scripts/raindrop.sh list -1 --limit 50
# Count unsorted
{baseDir}/scripts/raindrop.sh count -1
# Create collection and move bookmarks
{baseDir}/scripts/raindrop.sh create-collection "AI Coding"
{baseDir}/scripts/raindrop.sh move 12345 66016720
# Bulk move (efficient!)
{baseDir}/scripts/raindrop.sh bulk-move "123,456,789" 66016720
Commands
Reading
| Command | Description |
|---|---|
whoami |
Show authenticated user |
collections |
List all collections with IDs |
list [ID] |
List bookmarks (default: 0 = all) |
count [ID] |
Count bookmarks in collection |
search QUERY [ID] |
Search bookmarks |
get ID |
Get bookmark details |
tags |
List all tags with counts |
list-untagged [ID] |
Find bookmarks without tags |
cache ID |
Get permanent copy (Pro only) |
Writing
| Command | Description |
|---|---|
add URL [ID] |
Add bookmark (default: -1 = Unsorted) |
delete ID |
Delete bookmark |
create-collection NAME |
Create new collection |
move ID COLLECTION |
Move bookmark to collection |
update ID [opts] |
Update tags/title/collection |
bulk-move IDS TARGET [SOURCE] |
Move multiple bookmarks (source defaults to -1/Unsorted) |
suggest URL |
Get AI-suggested tags/title |
Options
| Flag | Description |
|---|---|
--json |
Raw JSON output |
--limit N |
Max results (default: 25) |
--page N |
Pagination (0-indexed) |
--delay MS |
Delay between API calls (rate limiting) |
--token TOKEN |
Override API token |
Update Options
For the update command:
| Flag | Description |
|---|---|
--tags TAG1,TAG2 |
Set tags (comma-separated) |
--title TITLE |
Set title |
--collection ID |
Move to collection |
Collection IDs
0= All bookmarks-1= Unsorted-99= TrashN= Specific collection (get IDs fromcollections)
Examples
# List unsorted with pagination
{baseDir}/scripts/raindrop.sh list -1 --limit 50 --page 0
{baseDir}/scripts/raindrop.sh list -1 --limit 50 --page 1
# Create collection
{baseDir}/scripts/raindrop.sh create-collection "AI Coding"
# Output: Created: AI Coding / ID: 66016720
# Move single bookmark
{baseDir}/scripts/raindrop.sh move 1234567 66016720
# Update bookmark with tags and move
{baseDir}/scripts/raindrop.sh update 1234567 --tags "claude-code,workflow,tips" --collection 66016720
# Bulk move with rate limiting (100ms between calls)
{baseDir}/scripts/raindrop.sh bulk-move "123,456,789,101112" 66016720 --delay 100
# Find untagged bookmarks in unsorted
{baseDir}/scripts/raindrop.sh list-untagged -1 --limit 100
# Get JSON for scripting
{baseDir}/scripts/raindrop.sh list -1 --json --limit 50 | jq '.items[]._id'
# Count unsorted bookmarks
{baseDir}/scripts/raindrop.sh count -1
Bulk Operations
For large batch operations, use bulk-move which uses the Raindrop batch API (up to 100 items per request):
# Get IDs from unsorted
ids=$({baseDir}/scripts/raindrop.sh list -1 --json --limit 100 | jq -r '[.items[]._id] | join(",")')
# Move all to collection
{baseDir}/scripts/raindrop.sh bulk-move "$ids" 66016720
Rate Limiting
Raindrop API has rate limits. For bulk operations:
- Use
--delay 100(100ms between calls) - Use
bulk-moveinstead of individualmovecalls - Process in batches of 50-100
Direct API
For operations not covered:
source ~/.config/raindrop.env
# Update tags
curl -X PUT "https://api.raindrop.io/rest/v1/raindrop/ID" \
-H "Authorization: Bearer $RAINDROP_TOKEN" \
-H "Content-Type: application/json" \
-d '{"tags": ["tag1", "tag2"]}'
# Bulk update (up to 100 IDs)
curl -X PUT "https://api.raindrop.io/rest/v1/raindrops" \
-H "Authorization: Bearer $RAINDROP_TOKEN" \
-H "Content-Type: application/json" \
-d '{"ids": [123, 456, 789], "collectionId": 12345}'
API docs: https://developer.raindrop.io/