https://github.com/adeze/raindrop-mcp
Raindrop MCP Server
https://github.com/adeze/raindrop-mcp
mcp mcp-server mcp-tools raindrop raindrop-api raindrop-io
Last synced: 3 months ago
JSON representation
Raindrop MCP Server
- Host: GitHub
- URL: https://github.com/adeze/raindrop-mcp
- Owner: adeze
- License: mit
- Created: 2025-03-25T03:10:15.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2026-01-21T06:20:49.000Z (4 months ago)
- Last Synced: 2026-01-21T17:04:25.839Z (4 months ago)
- Topics: mcp, mcp-server, mcp-tools, raindrop, raindrop-api, raindrop-io
- Language: TypeScript
- Homepage:
- Size: 205 MB
- Stars: 107
- Watchers: 3
- Forks: 19
- Open Issues: 38
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
- toolsdk-mcp-registry - ❌ @adeze/raindrop-mcp
- metorial-index - Raindrop.io Bookmark Manager - Manage and interact with Raindrop.io bookmarks, collections, tags, and highlights using the MCP server interface. Perform CRUD operations, advanced searches, tag management, and receive real-time updates. (File Management)
README
# 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 and library health metrics
- **collection_list** - List all collections as a flat list
- **get_collection_tree** - Hierarchical view of collections with full breadcrumb paths
- **collection_manage** - Create, update, or delete collections
- **bookmark_search** - Advanced search with filters, tags, and pagination
- **bookmark_manage** - Create, update, or delete bookmarks
- **get_raindrop** - Fetch a single bookmark by ID
- **list_raindrops** - List bookmarks for a collection with pagination
- **get_suggestions** - AI-powered organization advice (tags/collections) for a URL or bookmark
- **bulk_edit_raindrops** - Bulk update, move, or remove bookmarks in a specific collection
- **tag_manage** - Rename, merge, or delete tags
- **highlight_manage** - Create, update, or delete highlights
- **library_audit** - Scan library for broken links, duplicates, and untagged items
- **empty_trash** - Permanently empty the trash (requires confirmation)
- **cleanup_collections** - Remove empty collections (requires confirmation)
## 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.9)
### Smart Organization & Hierarchy
- **AI Suggestions**: New `get_suggestions` tool provides organizational advice using Raindrop's API and MCP Sampling.
- **Collection Tree**: `get_collection_tree` tool provides a hierarchical view with full breadcrumb paths.
- **Bulk Move**: Added `move` operation to `bulk_edit_raindrops` for efficient library organization.
- **Pagination Support**: Standardized `list_raindrops` and `bookmark_search` with pagination for large libraries.
### Safety & Quality
- **Confirmation Logic**: Destructive tools (`empty_trash`, `cleanup_collections`) now require explicit confirmation.
- **Standardized Naming**: All tools now use consistent snake_case naming conventions.
- **CI/CD Pipeline**: Enhanced GitHub Actions with automated linting, type-checking, and cross-transport tests.
- **Code Quality**: Established ESLint and Prettier configurations for maintainable development.
## 📋 Previous Enhancements (v2.3.3)
### Advanced Cleanup & Library Audit
## 📋 Previous 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.