raindrop-mcp-server

A Model Context Protocol (MCP) server implementation for Raindrop.io, exposing its API as a set of tools for AI agents and automated workflows.

Table of Contents

1. Quick Start
2. Installation
3. Configuration
4. Usage
5. Requirements
6. Troubleshooting
7. Contributing
8. License

Quick Start

1. Download the latest binary from GitHub Releases
2. Get API Token from Raindrop.io Settings → Integrations
3. Configure Claude Desktop (claude_desktop_config.json):

   {
     "mcpServers": {
       "raindrop": {
         "command": "/usr/local/bin/raindrop-mcp-server",
         "env": {
           "RAINDROP_ACCESS_TOKEN": "your_token_here"
         }
       }
     }
   }
   

4. Start using: Ask Claude to "Show me all my Raindrop collections"

Installation

Pre-built Binaries (Recommended)

Download from GitHub Releases:

Linux:

wget https://github.com/yamahigashi/raindrop-mcp-server-rs/releases/download/latest/raindrop-mcp-server-linux.tar.gz
tar -xzf raindrop-mcp-server-v0.1.0-linux.tar.gz
chmod +x raindrop-mcp-server-linux
sudo mv raindrop-mcp-server-linux /usr/local/bin/raindrop-mcp-server

Windows:

Invoke-WebRequest -Uri "https://github.com/yamahigashi/raindrop-mcp-server-rs/releases/download/v0.1.0/raindrop-mcp-server-v0.1.0-windows.zip" -OutFile "raindrop-mcp-server.zip"
Expand-Archive -Path "raindrop-mcp-server.zip" -DestinationPath "."
# Move raindrop-mcp-server-windows.exe to a directory in your PATH

From Source

git clone https://github.com/yamahigashi/raindrop-mcp-server-rs.git
cd raindrop-mcp-server-rs
cargo build --release
# Binary: ./target/release/raindrop-mcp-server

Configuration

1. Raindrop.io API Token

1. Log in to Raindrop.io
2. Go to Settings → Integrations
3. Create a new app or select an existing one
4. Generate an access token

2. MCP Client Setup

For Claude Desktop, edit claude_desktop_config.json:

{
  "mcpServers": {
    "raindrop": {
      "command": "/usr/local/bin/raindrop-mcp-server",
      "env": {
        "RAINDROP_ACCESS_TOKEN": "your_raindrop_access_token_here"
      }
    }
  }
}

For development, create .env file:

RAINDROP_ACCESS_TOKEN=your_raindrop_access_token_here
RUST_LOG=info

Usage

Once configured, the MCP server provides the following tools to AI assistants:

Collection Management

• get_collections - List all collections
• get_collection - Get a specific collection
• create_collection - Create a new collection
• update_collection - Update collection properties
• delete_collection - Delete a collection
• share_collection - Share a collection with others

Bookmark Operations

• get_bookmarks - Retrieve bookmarks with filtering
• get_bookmark - Get a specific bookmark
• create_bookmark - Create a new bookmark
• update_bookmark - Update bookmark properties
• delete_bookmark - Delete a bookmark
• search_bookmarks - Search bookmarks with advanced filters
• batch_update_bookmarks - Update multiple bookmarks at once
• batch_delete_bookmarks - Delete multiple bookmarks

Tag Management

• get_tags - List all tags or tags from a specific collection
• rename_tag - Rename a tag across all bookmarks
• delete_tag - Delete a single tag
• delete_tags - Delete multiple tags

Highlights

• get_highlights - Get highlights for a specific bookmark
• get_all_highlights - Get all highlights across bookmarks

User & Utility

• get_user_info - Get user account information
• get_user_stats - Get usage statistics
• empty_trash - Permanently delete all trashed bookmarks
• export_bookmarks - Export bookmarks in various formats
• get_import_status - Check import operation status
• get_export_status - Check export operation status

Example Interactions

Here are some example prompts you can use with an AI assistant:

• "Show me all my Raindrop collections"
• "Create a new collection called 'AI Research'"
• "Save this article to my 'Reading List' collection"
• "Find all bookmarks tagged with 'rust' and 'programming'"
• "Move all bookmarks from 'Unsorted' to 'Archive' collection"
• "Export my 'Work' collection as a CSV file"
• "Show me all highlights from the past week"

Requirements

For End Users (Pre-built Binaries)

• Operating System: Linux (x86_64) or Windows (x86_64)
• Raindrop.io Account: Valid API access token required

For Developers (Building from Source)

• Rust: 1.85 or later
• Operating System: Linux (x86_64) or Windows (x86_64)
• Raindrop.io Account: Valid API access token required

Troubleshooting

Common Issues

"Permission denied" when running the binary

chmod +x raindrop-mcp-server-linux

"RAINDROP_ACCESS_TOKEN not found"

• Ensure the token is set in your MCP client configuration
• Verify the token is valid at Raindrop.io Settings

"Connection refused" or timeout errors

• Check your internet connection
• Verify Raindrop.io API is accessible from your network

Claude Desktop not recognizing the server

• Restart Claude Desktop after configuration changes
• Check claude_desktop_config.json syntax with a JSON validator
• Verify the binary path is correct and executable

Debug Mode

Enable detailed logging:

RUST_LOG=debug /usr/local/bin/raindrop-mcp-server

License

This project is licensed under the MIT License - see the LICENSE file for details.