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 Raindrop collections and raindrops and tags from Claude Desktop in simple, human language. This can be paired with things like the Firecrawl MCP server to enable streamlined automation and organization of your Raindrop collections and tagging system.

Requirements

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

Setup

1. Obtain a Raindrop API Token

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

2. Set Your API Token

Set your Raindrop API token as an environment variable:

Create a .env file in the root directory
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

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 '' 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

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'"

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:

Fork the repository
Create a new branch (git checkout -b feature/your-feature-name)
Make your changes
Validate they work as intended
Commit your changes (git commit -m 'Add some feature')
Push to the branch (git push origin feature/your-feature-name)
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.