raindrop-mcp-server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@raindrop-mcp-server save https://example.com to my 'Dev' collection with tags react, tutorial"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Raindrop.io MCP Server
A Model Context Protocol (MCP) server for interacting with the Raindrop.io API. This server enables Claude Code and other MCP clients to manage bookmarks, collections, and tags in your Raindrop.io account.
Features
Raindrop (Bookmark) Management
Get single or multiple bookmarks
Search bookmarks across collections
Create new bookmarks with metadata
Update existing bookmarks
Delete bookmarks
Collection Management
List all collections (root and nested)
Get specific collection details
Create new collections
Update collection properties
Delete collections
Tag Management
Get all tags (optionally filtered by collection)
Rename tags
Merge multiple tags into one
Delete tags
User Information
Get current user profile and settings
Related MCP server: Raindrop.io MCP Server
Installation
Option 1: Easy Install with MCPB (Recommended)
The easiest way to install this MCP server is using the MCP Bundle (MCPB) file with Claude Desktop:
Download the
raindrop-mcp-server.mcpbfile from this repositoryDouble-click the file (or drag it into Claude Desktop)
Enter your API token when prompted - get it from https://app.raindrop.io/settings/integrations
That's it! The bundle contains everything needed and will automatically configure itself in Claude Desktop.
Option 2: Manual Installation
If you prefer manual installation or are using a different MCP client:
cd raindrop-mcp-server
npm installThen proceed with the manual configuration below.
Configuration
Manual Configuration (Skip if using MCPB)
1. Get Your Raindrop.io API Token
Create a new app or open an existing one
Copy the Test token from your app settings
2. Configure MCP Settings
Add the server to your Claude Code MCP settings file (~/.config/claude-code/mcp.json or equivalent):
{
"mcpServers": {
"raindrop": {
"command": "node",
"args": ["/home/user/raindrop-mcp-server/src/index.js"],
"env": {
"RAINDROP_TOKEN": "your-token-here"
}
}
}
}Replace your-token-here with your actual Raindrop.io test token.
Alternative: You can also set the token as an environment variable:
export RAINDROP_TOKEN="your-token-here"Available Tools
Bookmark Tools
get_raindrop
Get a single bookmark by ID.
Parameters:
id(string, required): The raindrop ID
get_raindrops
Get bookmarks from a collection with filtering and pagination.
Parameters:
collectionId(number, optional): Collection ID (0=all, -1=unsorted, -99=trash, default: 0)search(string, optional): Search querypage(number, optional): Page number (0-indexed, default: 0)perpage(number, optional): Results per page (max 50, default: 25)sort(string, optional): Sort order (-created, created, score, title, etc.)nested(boolean, optional): Include bookmarks from nested collections
search_raindrops
Search for bookmarks across all collections.
Parameters:
query(string, required): Search query textpage(number, optional): Page numberperpage(number, optional): Results per page
create_raindrop
Create a new bookmark.
Parameters:
link(string, required): URL to bookmarktitle(string, optional): Bookmark titleexcerpt(string, optional): Descriptionnote(string, optional): Personal notescollection(number, optional): Collection ID (-1 for Unsorted)tags(array, optional): Array of tag stringsimportant(boolean, optional): Mark as favoritepleaseParse(object, optional): Auto-parse metadata from URL
update_raindrop
Update an existing bookmark.
Parameters:
id(string, required): The raindrop ID to updatelink,title,excerpt,note,collection,tags,important(optional): Fields to update
delete_raindrop
Delete a bookmark (moves to trash, or permanently deletes if already in trash).
Parameters:
id(string, required): The raindrop ID to delete
Collection Tools
get_collections
Get all root-level collections.
get_child_collections
Get all nested (child) collections.
get_collection
Get a specific collection by ID.
Parameters:
id(string, required): The collection ID
create_collection
Create a new collection.
Parameters:
title(string, required): Collection nameview(string, optional): Display view (list, grid, masonry)sort(number, optional): Sort orderpublic(boolean, optional): Public accessibilityparentId(number, optional): Parent collection ID for nesting
update_collection
Update an existing collection.
Parameters:
id(string, required): The collection IDtitle,view,sort,public,parentId,expanded(optional): Fields to update
delete_collection
Delete a collection by ID.
Parameters:
id(string, required): The collection ID
Tag Tools
get_tags
Get all tags, optionally filtered by collection.
Parameters:
collectionId(number, optional): Filter tags by collection
rename_tag
Rename a tag across all or specific collection.
Parameters:
oldTag(string, required): Current tag namenewTag(string, required): New tag namecollectionId(number, optional): Limit scope to collection
merge_tags
Merge multiple tags into one.
Parameters:
oldTags(array, required): Array of tag names to mergenewTag(string, required): Target tag namecollectionId(number, optional): Limit scope to collection
delete_tags
Delete one or more tags.
Parameters:
tags(array, required): Array of tag names to deletecollectionId(number, optional): Limit scope to collection
User Tools
get_user
Get current user information and profile.
Usage Examples
Once configured in Claude Code, you can interact with your Raindrop.io bookmarks naturally:
"Show me my recent bookmarks"
"Create a bookmark for https://example.com with tags 'programming' and 'tutorial'"
"Search for bookmarks about 'machine learning'"
"Create a new collection called 'Research Papers'"
"Move bookmark ID 12345 to collection ID 67890"
"Get all my tags"
"Rename tag 'js' to 'javascript'"API Rate Limits
The Raindrop.io API allows up to 120 requests per minute per authenticated user. The rate limit headers will be included in responses:
X-RateLimit-LimitRateLimit-RemainingX-RateLimit-Reset
About MCP Bundles (MCPB)
This project includes an MCP Bundle (.mcpb file) for simplified installation. MCPB is a standardized format for packaging MCP servers with all their dependencies and configuration metadata.
Benefits of using MCPB:
One-click installation in Claude Desktop
No manual configuration of paths or dependencies
Self-contained - includes all node_modules and code
Automatic updates - easier to distribute new versions
User-friendly - prompts for required configuration (like API tokens)
The .mcpb file is essentially a zip archive containing:
Server source code
All npm dependencies
A
manifest.jsonwith metadata and configuration schemaLicense and documentation
Learn more about MCP Bundles: https://github.com/anthropics/mcpb
Documentation
License
MIT
Available Tools
15 toolscreate_collectionC
Create a new collection.
Inputs: title (required), sort, view, public, +1 more.
create_raindropC
Create a new bookmark.
Inputs: link (required), note, tags, title, +4 more.
delete_collectionB
Delete a collection by ID.
Inputs: id (required).
delete_raindropA
Delete a bookmark by ID. Moves to trash, or permanently deletes if already in trash.
Inputs: id (required).
delete_tagsB
Delete one or more tags.
Inputs: tags (required), collectionId.
get_collectionA
Get a specific collection by ID.
Inputs: id (required).
get_collectionsA
Get root-level collections. Set include_children=true to also return nested collections.
Inputs: include_children.
get_raindropA
Get a single bookmark by ID.
Inputs: id (required).
get_raindropsA
Get bookmarks from a collection with optional search and filtering. collectionId: 0=all, -1=unsorted, -99=trash.
Inputs: page, sort, nested, search, +2 more.
get_tagsA
Get all tags, optionally filtered by collection.
Inputs: collectionId.
get_userA
Get current user information.
Inputs: no named parameters.
merge_tagsC
Merge multiple tags into one.
Inputs: newTag (required), oldTags (required), collectionId.
rename_tagB
Rename a tag across all or a specific collection.
Inputs: newTag (required), oldTag (required), collectionId.
update_collectionC
Update an existing collection.
Inputs: id (required), sort, view, title, +3 more.
update_raindropB
Update an existing bookmark by ID.
Inputs: id (required), link, note, tags, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 15 tools
Each tool targets a distinct resource (collection, raindrop, tag, user) and action (get, create, update, delete, merge, rename). Singular/plural forms differentiate single vs. batch operations clearly, so there is no ambiguity between tools.
All tools follow a consistent verb_noun pattern (e.g., get_collection, create_raindrop, delete_tags). The only minor deviation is plural vs. singular nouns (get_collection vs. get_collections), but this is a natural and predictable distinction for batch vs. single operations.
With 15 tools, the server is well-scoped for a bookmark manager: full CRUD for collections and raindrops, tag management, and user info. Each tool has a clear purpose, and the count is neither sparse nor overwhelming.
The tool surface covers the full lifecycle for collections, raindrops, and tags (create, read, update, delete, merge, rename). Search/filtering is integrated into get_raindrops, and user info is provided. There are no obvious missing operations for the domain.
Related MCP Connectors
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Recall MCP server for ChatGPT, Claude and any AI agent: save URL, create note, add tags to card, remove tags from card, delete card, export card as Markdown, search cards and list card connections in your own Recall account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Recall yourself; Cotlet does not store your password and you need no Recall API key. About the official Recall API: Yes, but it only reads. Recall has a REST API and an MCP server, both included in the Free plan, and both are read-only (checked 25 Oct 2026). Setup and FAQ: https://cotlet.dev/integrations/recall-api-mcp-server
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that allows Claude Desktop to access and manage Raindrop.io bookmarks through natural language commands, supporting operations for collections, raindrops, and tags.128MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to access and manage Raindrop.io bookmarks, collections, tags, and highlights through the Model Context Protocol. Supports CRUD operations, advanced search, file uploads, and bulk editing of bookmarks.MIT
- FlicenseAqualityDmaintenanceEnables to manage Raindrop.io bookmarks programmatically—add, search, and organize bookmarks from LLM apps.415-
- AlicenseBqualityCmaintenanceExposes the Raindrop.io API as Claude tools for managing bookmarks, collections, tags, and bulk operations, with proper collection move support.191MIT