Features
- Bookmark management — create, read, update, and delete individual bookmarks with titles, notes, tags, and excerpts.
- Bulk operations — move, tag, or delete multiple bookmarks in a single call.
- Collection organisation — list, create, update, and delete root and nested collections.
- Tag control — list, rename, merge, and delete tags across your entire library or scoped to a collection.
- Highlights — fetch, create, update, and delete inline highlights with colour and notes.
- Library audit — surface broken links, duplicates, and untagged bookmarks in one tool call.
Install
npx --yes @kud/mcp-raindrop-io@latestUsage
Add the server to your MCP client config and pass a Raindrop.io API token via MCP_RAINDROPIO_TOKEN:
{
"mcpServers": {
"raindrop-io": {
"command": "npx",
"args": ["--yes", "@kud/mcp-raindrop-io@latest"],
"env": {
"MCP_RAINDROPIO_TOKEN": "your-token-here"
}
}
}
}| Tool | Description |
|---|---|
search_raindrops | Search or list bookmarks with advanced filters |
get_raindrop | Get a single bookmark by ID |
create_raindrop | Create a new bookmark |
update_raindrop | Update an existing bookmark |
delete_raindrop | Delete a bookmark (moves to trash) |
create_raindrops | Create multiple bookmarks in bulk |
bulk_raindrops | Bulk update, move, or delete bookmarks in a collection |
get_collections | List all root collections |
get_child_collections | List all child (nested) collections |
get_collection | Get a single collection by ID |
create_collection | Create a new collection |
update_collection | Update a collection |
delete_collection | Delete a collection and all its bookmarks |
cleanup_collections | Remove all empty collections |
get_tags | List all tags, optionally scoped to a collection |
manage_tags | Rename, merge, or delete tags |
get_highlights | Get highlights — all, by collection, or by bookmark |
manage_highlight | Create, update, or delete a highlight |
get_user | Get authenticated user info and stats |
parse_url | Extract metadata from any URL before saving |
check_urls_exist | Check if URLs are already saved as bookmarks |
library_audit | Scan library for broken links, duplicates, and untagged bookmarks |
empty_trash | Permanently delete all bookmarks in trash |
Development
git clone https://github.com/kud/mcp-raindrop-io.git
cd mcp-raindrop-io
npm install
npm run dev