adeze/raindrop-mcp
If you are the rightful owner of raindrop-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.
The Raindrop.io MCP Server allows interaction with the Raindrop.io bookmarking service using the Model Context Protocol (MCP), enabling AI agents to manage bookmarks efficiently.
Raindrop.io MCP Server
Connect Raindrop.io to your AI assistant with a simple MCP server. Use it to organize, search, and manage bookmarks with natural language.
What it can do
- Create, update, and delete collections and bookmarks
- Search bookmarks by tags, domain, type, date, and more
- Manage tags (list, rename, merge, delete)
- Read highlights from bookmarks
- Bulk edit bookmarks in a collection
- Import/export bookmarks and manage trash
Tools
- diagnostics - Server diagnostic information
- collection_list - List all collections
- collection_manage - Create, update, or delete collections
- bookmark_search - Search bookmarks
- bookmark_manage - Create, update, or delete bookmarks
- tag_manage - Rename, merge, or delete tags
- highlight_manage - Create, update, or delete highlights
- getRaindrop - Fetch single bookmark by ID (legacy)
- listRaindrops - List bookmarks for a collection (legacy)
- bulk_edit_raindrops - Bulk update tags, favorite status, media, cover, or move bookmarks
Install
Claude Desktop (MCPB)
Download the latest raindrop-mcp.mcpb from the GitHub Release and add it to Claude Desktop:
In Claude Desktop, add the bundle and set this environment variable:
- RAINDROP_ACCESS_TOKEN (from your Raindrop.io integrations settings)
NPX (CLI)
Set your API token as an environment variable and run:
export RAINDROP_ACCESS_TOKEN=YOUR_RAINDROP_ACCESS_TOKEN
npx @adeze/raindrop-mcp
Manual MCP config (mcp.json)
Add this to your MCP client configuration:
{
"servers": {
"raindrop": {
"type": "stdio",
"command": "npx",
"args": ["@adeze/raindrop-mcp@latest"],
"env": {
"RAINDROP_ACCESS_TOKEN": "YOUR_RAINDROP_ACCESS_TOKEN"
}
}
}
}
Requirements
- A Raindrop.io account
- A Raindrop.io API Access Token: https://app.raindrop.io/settings/integrations
Support
📋 Recent Enhancements (v2.3.2)
MCP Resource Links Implementation
- Modern
resourcecontent following MCP SDK v1.25.3 best practices - Efficient data access: tools return lightweight links instead of full payloads
- Better performance: clients fetch full bookmark/collection data only when needed
- Seamless integration with dynamic resource system (
mcp://raindrop/{id})
SDK & API Updates
- Updated to MCP SDK v1.25.3
- Modern tool registration with improved descriptions
- Fixed API endpoints and path parameters
- All core tools fully functional
Tool Optimization
- Resource-efficient responses for bookmark/collection lists
- Dynamic resource access via
mcp://collection/{id}andmcp://raindrop/{id} - Better client UX with lighter list payloads
- Full MCP compliance with official SDK patterns
Service Layer Improvements
- Reduced code through extracted common helpers
- Consistent error handling and response processing
- Enhanced type safety with generic handlers
- Centralized endpoint building
Testing Improvements
- Stronger end-to-end coverage for MCP tool execution
- Expanded integration tests for real-world client flows
MCP 2.0 Preparation (Bulk Ops)
- Laying groundwork for MCP 2.0 bulk-operation workflows and tooling
OAuth (Coming Soon)
- OAuth-based auth flow to simplify setup without manual tokens
Note
Apologies to anyone affected by the last couple of builds. Thank you for the patience and reports.
License
This project is licensed under the MIT License - see the file for details.
