Raindrop.io

by ddaltn

2 stars

Not rated

GitHub

About

Integrates with Raindrop.io to enable natural language management of bookmarking collections and tags for streamlined organization workflows.

Details

Author: ddaltn
Repository: ddltn/raindrop-mcp-python
GitHub stars: 2
License: MIT License
Categories: Productivity, Design, Developer Tools, AI, Infrastructure, Frontend
Tags: #web

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Raindrop.io

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 @highlight/mcp-server
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "raindrop.io": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "raindrop.io": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "raindrop.io": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "raindrop.io": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "raindrop.io": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "raindrop.io": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "raindrop.io": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "raindrop.io": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "raindrop.io": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "raindrop.io": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "raindrop.io": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "raindrop.io": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "raindrop.io": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "raindrop.io": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "raindrop.io": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

From the repository

To install the server to Claude Desktop:

uv run mcp install server.py

This will start the server locally and allow you to test changes.

`create_collection`

Creates a new collection in Raindrop.io. Parameters: title (required), view (optional), public (optional), parent_id (optional)

`update_collection`

Updates an existing collection in Raindrop.io. Parameters: collection_id (required), title (optional), view (optional), public (optional), parent_id (optional), expanded (optional)

`delete_collection`

Deletes a collection from Raindrop.io. The raindrops will be moved to Trash. Parameters: collection_id (required)

`empty_trash`

Empties the trash in Raindrop.io, permanently deleting all raindrops in it.

`get_raindrop`

Gets a single raindrop from Raindrop.io by ID. Parameters: raindrop_id (required)

`get_raindrops`

Gets multiple raindrops from a Raindrop.io collection. Parameters: collection_id (required), search (optional), sort (optional), page (optional), perpage (optional), nested (optional)

`get_tags`

Gets tags from Raindrop.io. Parameters: collection_id (optional)

`update_raindrop`

Updates an existing raindrop (bookmark) in Raindrop.io. Parameters: raindrop_id (required), title (optional), excerpt (optional), link (optional), important (optional), tags (optional), collection_id (optional), cover (optional), type (optional), order (optional), pleaseParse (optional)

`update_many_raindrops`

Updates multiple raindrops at once within a collection. Parameters: collection_id (required), ids (optional), important (optional), tags (optional), cover (optional), target_collection_id (optional), nested (optional), search (optional)

The server provides the following MCP tools that let Claude Desktop perform actions on your Raindrop collections:

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "raindrop.io": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "cmd"
}

Raindrop MCP Server

This is a Model Context Protocol (MCP) server for Raindrop.io powered by the Python MCP SDK. It provides an easy way to read and update your bookmarks from the Raindrop personal knowledge management system in simple, human language. This can be paired with the Firecrawl MCP server to read the URLs associated with your bookmarks and classify them accordingly.

Requirements

- Python 3.12+
- uv package manager
- Claude Desktop
- A Raindrop.io account and API token

Setup

1. Obtain a Raindrop API Token

1. Go to Raindrop.io Developer Portal
2. Create a new app
3. Copy your API token

2. Set Your API Token

Set your Raindrop API token as an environment variable:

1. Create a .env file in the root directory
2. Add new line: ``RAINDROP_TOKEN="your_token_here"


Development
To run the server in development mode:



uv run mcp dev server.py



Installation

To install the server to Claude Desktop:


uv run mcp install server.py


This will start the server locally and allow you to test changes.
Features
The server provides:
- Access to your Raindrop collections and raindrop data through capabilities

- Support for viewing root collections, child collections, or a specific collection by ID

- Tools to create, update, and delete collections and raindrops

- Tools to create and update new tags
Example Queries
After installing the server to Claude Desktop, you can ask Claude questions and commands like:
- "Show me all my Raindrop collections"

- "Do I have any collections related to programming?"

- "Add this tag to all raindrops in this collection"

- "Show me the details of my Raindrop collection with ID 12345"

- "What child collections do I have in Raindrop?"

- "Create a new Raindrop collection called 'Claude Resources'"
Here is some example usage in Claude Desktop (paired with a Firecrawl MCP server):
Input to Claude Desktop as the classificaiton system:


Output from Claude Desktop:


Tools
The server provides the following MCP tools that let Claude Desktop perform actions on your Raindrop collections:
create_collection
Creates a new collection in Raindrop.io.

Parameters: -title(required): Name of the collection -view: View type (list, grid, masonry, simple) -public: Whether the collection is public -parent_id: ID of parent collection (omit for root collection)


update_collection
Updates an existing collection in Raindrop.io.

Parameters: -collection_id(required): ID of the collection to update -title: New name for the collection -view: View type (list, grid, masonry, simple) -public: Whether the collection is public -parent_id: ID of parent collection (omit for root collection) -expanded: Whether the collection is expanded


delete_collection
Deletes a collection from Raindrop.io. The raindrops will be moved to Trash.

Parameters: -collection_id (required): ID of the collection to delete


empty_trash
Empties the trash in Raindrop.io, permanently deleting all raindrops in it.
get_raindrop
Gets a single raindrop from Raindrop.io by ID.

Parameters: -raindrop_id (required): ID of the raindrop to fetch


get_raindrops
Gets multiple raindrops from a Raindrop.io collection.

Parameters: -collection_id(required): ID of the collection to fetch raindrops from. Use 0 for all raindrops, -1 for unsorted, -99 for trash. -search: Optional search query -sort: Sorting order (options: -created, created, score, -sort, title, -title, domain, -domain) -page: Page number (starting from 0) -perpage: Items per page (max 50) -nested: Whether to include raindrops from nested collections


get_tags
Gets tags from Raindrop.io.

Parameters: -collection_id: Optional ID of the collection to fetch tags from. When not specified, all tags from all collections will be retrieved.


update_raindrop
Updates an existing raindrop (bookmark) in Raindrop.io.

Parameters: -raindrop_id(required): ID of the raindrop to update -title: New title for the raindrop -excerpt: New description/excerpt -link: New URL -important: Set to True to mark as favorite -tags: List of tags to assign -collection_id: ID of collection to move the raindrop to -cover: URL for the cover image -type: Type of the raindrop -order: Sort order (ascending) - set to 0 to move to first place -pleaseParse: Set to True to reparse metadata (cover, type) in the background


update_many_raindrops
Updates multiple raindrops at once within a collection.

Parameters: -collection_id(required): ID of the collection containing raindrops to update -ids: Optional list of specific raindrop IDs to update -important: Set to True to mark as favorite, False to unmark -tags: List of tags to add (or empty list to remove all tags) -cover: URL for cover image (use '<screenshot>' to set screenshots for all) -target_collection_id: ID of collection to move raindrops to -nested: Include raindrops from nested collections -search: Optional search query to filter which raindrops to update


Dependencies

Please see pyproject.toml for dependancies.

These will be installed automatically when using uv run mcp install or uv run mcp dev.


Contributing
Contributions are welcome! Here's how you can contribute to this project:

1. Fork the repository 2. Create a new branch (git checkout -b feature/your-feature-name) 3. Make your changes 4. Validate they work as intended 5. Commit your changes (git commit -m 'Add some feature') 6. Push to the branch (git push origin feature/your-feature-name`)
7. Open a pull request

Please ensure your code follows the existing style and includes appropriate documentation.

License

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

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

create_collection

update_collection

delete_collection

empty_trash

get_raindrop

get_raindrops

get_tags

update_raindrop

update_many_raindrops

Claude Desktop / Cursor

Linux

Macos

Windows

Raindrop MCP Server

Requirements

Setup

1. Obtain a Raindrop API Token

2. Set Your API Token

Development

Installation

Features

Example Queries

Tools

create_collection

update_collection

delete_collection

empty_trash

get_raindrop

get_raindrops

get_tags

update_raindrop

update_many_raindrops

Dependencies

Contributing

License

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7

`create_collection`

`update_collection`

`delete_collection`

`empty_trash`

`get_raindrop`

`get_raindrops`

`get_tags`

`update_raindrop`

`update_many_raindrops`