# Raindrop.io MCP Server
[](https://smithery.ai/server/@adeze/raindrop-mcp)
[](https://www.npmjs.com/package/@adeze/raindrop-mcp)
[](https://github.com/adeze/raindrop-mcp/releases)
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:
- Releases: https://github.com/adeze/raindrop-mcp/releases
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:
```bash
export RAINDROP_ACCESS_TOKEN=YOUR_RAINDROP_ACCESS_TOKEN
npx @adeze/raindrop-mcp
```
### Manual MCP config (mcp.json)
Add this to your MCP client configuration:
```json
{
"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
- Issues: https://github.com/adeze/raindrop-mcp/issues
## 📋 Recent Enhancements (v2.3.2)
### MCP Resource Links Implementation
- Modern `resource` content 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}` and `mcp://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 [LICENSE](LICENSE) file for details.
