Raindrop.io MCP Server logo

Raindrop.io MCP Server

by adeze

This project provides a Model Context Protocol (MCP) server for interacting with the Raindrop.io bookmarking service. It allows Language Models (LLMs) and other AI agents to access and manage your Raindrop.io data through the MCP standard.

View on GitHub

Last updated: N/A

What is Raindrop.io MCP Server?

The Raindrop.io MCP Server is a bridge between Raindrop.io and Language Models (LLMs) or other AI agents, enabling them to interact with your Raindrop.io bookmarks and collections using the Model Context Protocol (MCP). It exposes Raindrop.io functionalities as MCP resources and tools.

How to use Raindrop.io MCP Server?

  1. Obtain a Raindrop.io API Access Token. 2. Install the server using NPX or from source (cloning the repository, installing dependencies, and configuring environment variables). 3. Run the server. 4. Configure your MCP client (e.g., Claude Code) to connect to the server via stdio, providing the necessary configuration in your .mcp.json file.

Key features of Raindrop.io MCP Server

  • CRUD Operations for collections and bookmarks

  • Advanced Search for bookmarks

  • Tag Management (list, rename, merge, delete)

  • Highlight Access from bookmarks

  • Collection Management (reorder, expand/collapse, merge, remove empty)

  • File Upload directly to Raindrop.io

  • Reminders for specific bookmarks

  • Import/Export bookmark functionality

  • Trash Management (empty the trash)

  • MCP Compliance

  • Streaming Support for bookmark updates (SSE)

Use cases of Raindrop.io MCP Server

  • Integrate Raindrop.io bookmarks into AI assistants for knowledge retrieval.

  • Automate bookmark management tasks using LLMs.

  • Build custom applications that leverage Raindrop.io data.

  • Enable AI agents to create, update, and delete bookmarks based on user instructions.

FAQ from Raindrop.io MCP Server

What is MCP?

MCP stands for Model Context Protocol, a standard for enabling communication and interaction between Language Models and external services.

How do I get a Raindrop.io API Access Token?

You can create an API Access Token in your Raindrop.io settings under the Integrations section.

What is the recommended way to install the server?

Using NPX is the recommended way to run the server as it avoids the need for global installation.

How do I configure my MCP client to use this server?

You need to add a configuration block to your .mcp.json file, specifying the command to run the server and any necessary environment variables (like the Raindrop.io API Access Token).

What resources and tools are exposed by this server?

The server exposes resources for collections, tags, highlights, bookmarks, and user information, along with tools for managing these resources. Refer to CLAUDE.md or src/services/mcp.service.ts for a detailed list.