Home / MCP / Raindrop MCP Server

Raindrop MCP Server

Provides access to Raindrop.io collections, raindrops, and tags; supports create/update/delete operations and tagging.

python

7stars

View on GitHub

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
    "mcpServers": {
        "raindrop": {
            "command": "uv",
            "args": [
                "run",
                "mcp",
                "dev",
                "server.py"
            ],
            "env": {
                "RAINDROP_TOKEN": "YOUR_TOKEN"
            }
        }
    }
}

This Raindrop MCP Server lets you read, create, update, and organize your Raindrop.io bookmarks from an MCP client. It exposes Raindrop collections, raindrops, and tags as programmable capabilities, so you can manage your knowledge base in natural language and automate curation tasks from your preferred MCP client.

How to use

You interact with the Raindrop MCP Server through an MCP client to view and modify your Raindrop collections, raindrops, and tags. Use the available tools to create, update, or delete collections, fetch raindrops by collection or search, and assign or move tags. Pair the server with other MCP services to combine data and automate workflows. For example, you can ask your client to show all collections, filter for programming-related items, fetch details for a specific collection, or add a new tag to multiple raindrops.

How to install

Prerequisites you need before installing and running this server are Python 3.12 or newer and the uv package manager. You also need a Raindrop.io account and an API token. Install steps below keep you in control of the local server that powers your MCP interactions.

1) Install Python-compatible dependencies and the MCP runtime if needed. 2) Prepare your environment with your Raindrop API token. 3) Run the development server to test changes locally.

To run in development mode, use the following command.

Configuration and environment

Obtain a Raindrop API token and set it in your environment so the server can access your Raindrop data.

Steps to configure the Raindrop token locally:

1) Create a file named .env in the project root.

2) Add the following line with your token.

RAINDROP_TOKEN="your_token_here"

Security and tips

Treat your Raindrop API token as a sensitive credential. Do not commit .env files to version control. When deploying, consider using environment variable management provided by your hosting or runtime platform.

Tools and capabilities overview

The server exposes a set of MCP tools to read and modify your Raindrop data. You can create, update, and delete collections, fetch raindrops by collection or by search, manage tags, and update individual raindrops. Use these tools to automate routine curation tasks and to integrate Raindrop data into larger MCP-enabled workflows.

Available tools

create_collection

Creates a new Raindrop collection with a title and optional view style and privacy settings.

update_collection

Updates details of an existing collection, including title, view, privacy, parent, and expansion state.

delete_collection

Deletes a Raindrop collection; contained raindrops are moved to Trash.

empty_trash

Permanently removes all raindrops in the Trash.

get_raindrop

Fetches a single raindrop by its ID from Raindrop.io.

get_raindrops

Retrieves multiple raindrops from a collection with optional filtering, sorting, pagination, and nested retrieval.

get_tags

Retrieves tags from Raindrop.io, optionally scoped to a specific collection.

update_raindrop

Updates a raindrop’s title, excerpt, link, tags, collection, and other metadata.

update_many_raindrops

Updates multiple raindrops in a collection, including tags, visibility, and movement between collections.