raindrop

Raindrop MCP server bridges Raindrop.io with your AI assistant via MCP (Model Context Protocol). It exposes a set of tools that let you manage and query your Raindrop bookmarks through natural language, including creating, updating, and deleting collections and bookmarks, searching by tags, domains, or other attributes, and handling highlights and bulk edits. Tools like collection_list, bookmark_search, and tag_manage enable targeted operations, while newer additions provide lightweight, resource-oriented responses so clients can fetch full objects only when needed. You can also access legacy endpoints via getRaindrop and listRaindrops if your client relies on older tooling. To use it, run the MCP server with NPX (or your preferred environment) and provide your Raindrop API access token as an environment variable.

Prerequisites:

• Node.js (with npm/npx) installed on your system
• A Raindrop.io account and a valid API access token

Installation steps:

1. Ensure Node.js and npm are installed. You can verify with: node -v npm -v

2. Run the MCP server using NPX (no global install required):

export RAINDROP_ACCESS_TOKEN=YOUR_RAINDROP_ACCESS_TOKEN
npx @adeze/raindrop-mcp@latest

3. Alternatively, configure a manual MCP entry in your client (mcp.json) as shown in the README to connect via npx:

{
  "servers": {
    "raindrop": {
      "type": "stdio",
      "command": "npx",
      "args": ["@adeze/raindrop-mcp@latest"],
      "env": {
        "RAINDROP_ACCESS_TOKEN": "YOUR_RAINDROP_ACCESS_TOKEN"
      }
    }
  }
}

4. Set your Raindrop API token in the environment variable RAINDROP_ACCESS_TOKEN before starting the server. Keep this token secure.

Notes:

• If you’re using Claude Desktop MCPB, you can install the bundle from releases and set RAINDROP_ACCESS_TOKEN in your environment as described in the README.
• Some environments may require a local internet access or proxy configuration to fetch the NPX package.

Tips and common issues:

• Ensure RAINDROP_ACCESS_TOKEN is valid and has the necessary permissions in Raindrop.io settings.
• If you encounter authentication errors, re-check token scope and re-export the token before restarting the MCP server.
• The tools return lightweight resource links by default; clients should fetch full bookmark/collection data on demand to improve performance.
• For legacy clients using getRaindrop or listRaindrops, confirm compatibility with MCP SDK v1.25.3 features.
• When upgrading to newer MCP SDK versions, revalidate tool registrations and endpoints to ensure compatibility with your client.
• If using Claude Desktop MCPB, ensure the latest raindrop-mcp.mcpb is downloaded from releases and that the environment variable RAINDROP_ACCESS_TOKEN is set in Claude Desktop as well.