Raindrop Bookmark Management

Guide for using the Raindrop.io MCP server to manage bookmarks effectively.

Available MCP Tools

Bookmark Operations

| Tool | Purpose | |------|---------| | create-raindrop | Save a new bookmark with optional metadata | | create-raindrops-bulk | Batch save multiple bookmarks (up to 50) | | get-raindrop | Get details of a specific bookmark | | list-raindrops | List bookmarks from a collection | | update-raindrop | Modify bookmark properties | | delete-raindrop | Move to trash or permanently delete | | search-raindrops | Full-text and operator search |

Collection Operations

| Tool | Purpose | |------|---------| | list-collections | Get all collections (folders) | | get-collection | Get specific collection details | | create-collection | Create new collection | | update-collection | Modify collection properties | | delete-collection | Remove collection (bookmarks go to trash) |

Tag Operations

| Tool | Purpose | |------|---------| | list-tags | Get all tags with counts | | merge-tags | Rename or consolidate tags | | delete-tags | Remove tags from bookmarks |

Other Tools

| Tool | Purpose | |------|---------| | list-highlights | Get text highlights from articles | | parse-url | Preview URL metadata before saving | | check-url-exists | Check for duplicate bookmarks |

Special Collection IDs

0 - All bookmarks across collections
-1 - Unsorted (default for new bookmarks)
-99 - Trash

Search Operators

#tag              Search by tag
site:example.com  Filter by domain
type:article      Filter by type (article/image/video/document/audio)
important:true    Favorites only
created:YYYY-MM-DD  Date filter

Field Presets

Optimize response size with presets:

| Preset | Fields Included | |--------|-----------------| | minimal | _id, link, title | | basic | + excerpt, tags, created, domain | | standard | + note, type, cover, lastUpdate, important | | media | _id, link, title, cover, media, type, file | | organization | _id, title, tags, collection, collectionId, sort, removed | | metadata | _id, created, lastUpdate, creatorRef, user, broken, cache |

Common Workflows

Save URL with Tags

Use create-raindrop with:
- link: "https://example.com/article"
- tags: ["research", "ai"]
- collectionId: 12345 (or omit for Unsorted)
- pleaseParse: true (auto-extract metadata)

Organize Bookmarks

1. list-collections to see available folders
2. create-collection for new category
3. update-raindrop with collectionId to move items

Clean Up Tags

1. list-tags to see all tags with counts
2. merge-tags to consolidate similar tags
3. delete-tags to remove unused ones

Research Workflow

1. parse-url to preview before saving
2. check-url-exists to avoid duplicates
3. create-raindrop to save with notes
4. search-raindrops later to find content

Environment Setup

Requires RAINDROP_TOKEN environment variable. Get your token from: https://app.raindrop.io/settings/integrations

Set in ~/.dotfiles/local/.env:

export RAINDROP_TOKEN="your-token-here"