Raindrop Io MCP Server

What is Raindrop Io MCP Server about?

Provides an MCP‑compatible server that lets large language models interact with a user's Raindrop.io bookmark library. The server exposes tools for creating bookmarks, searching them, and filtering by tags or collections.

How to use Raindrop Io MCP Server?

1. Install the server via Smithery (recommended) or manually.

   npx -y @smithery/cli install @hiromitsusasaki/raindrop-io-mcp-server --client claude
   

2. Set the RAINDROP_TOKEN environment variable with your Raindrop.io API token.
3. Add a server entry to Claude for Desktop configuration, pointing to the built index.js.
4. Restart Claude; the LLM can now call the create-bookmark and search-bookmarks tools.

Key features of Raindrop Io MCP Server

• Create bookmarks – supply URL, title, tags, and collection ID.
• Search bookmarks – free‑text query with optional tag filters.
• Tag‑based filtering – narrow results by one or more tags.
• Easy installation – single‑command install via Smithery or npm.
• Security‑focused – API token managed via environment variables only.

Use cases of Raindrop Io MCP Server

• Personal knowledge assistants that can automatically save referenced URLs while chatting.
• Research workflows where the LLM retrieves previously saved sources based on topic keywords.
• Automated curation of reading lists filtered by tags (e.g., "tech", "health").
• Integration with Claude for Desktop to enhance productivity without leaving the chat interface.

FAQ from the Raindrop Io MCP Server

Q: Which LLM clients are supported? A: The server follows the MCP specification; it works with any client that implements MCP, such as Claude for Desktop.

Q: Do I need a paid Raindrop.io plan? A: No, a free Raindrop.io account with an API token is sufficient.

Q: How are credentials protected? A: Credentials are stored only in environment variables (RAINDROP_TOKEN) and never hard‑coded.

Q: Can I run the server locally? A: Yes. After building (npm run build), run node PATH_TO_BUILD/index.js or use the npx command provided.

Q: Where can I contribute? A: The project is open source under the MIT license; contributions are welcome via pull requests on GitHub.

Raindrop.io MCP Server

An integration that allows LLMs to interact with Raindrop.io bookmarks using the Model Context Protocol (MCP).

Features

• Create bookmarks
• Search bookmarks
• Filter by tags

Requirements

• Node.js 16 or higher
• Raindrop.io account and API token

Setup

Installing via Smithery

To install Raindrop.io Integration for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @hiromitsusasaki/raindrop-io-mcp-server --client claude

Manual Installation

1. Clone the repository:

git clone https://github.com/hiromitsusasaki/raindrop-io-mcp-server
cd raindrop-io-mcp-server

2. Install dependencies:

npm install

3. Set up environment variables:

• Create a .env file and set your Raindrop.io API token

RAINDROP_TOKEN=your_access_token_here

4. Build:

npm run build

Using with Claude for Desktop

1. Open Claude for Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the following configuration:

{
  "mcpServers": {
    "raindrop": {
      "command": "node",
      "args": ["PATH_TO_BUILD/index.js"],
      "env": {
        "RAINDROP_TOKEN": "your_access_token_here"
      }
    }
  }
}

3. Restart Claude for Desktop

Available Tools

create-bookmark

Creates a new bookmark.

Parameters:

• url: URL to bookmark (required)
• title: Title for the bookmark (optional)
• tags: Array of tags (optional)
• collection: Collection ID (optional)

search-bookmarks

Searches through bookmarks.

Parameters:

• query: Search query (required)
• tags: Array of tags to filter by (optional)

Development

# Build for development
npm run build

# Start server
npm start

Security Notes

• Always manage API tokens using environment variables
• Set appropriate permissions for Claude for Desktop configuration files
• Restrict unnecessary file access

Open Source

This is an open source MCP server that anyone can use and contribute to. The project is released under the MIT License.

Contributing

Contributions are welcome! Feel free to submit issues, feature requests, or pull requests to help improve this project.

Related Links

• Model Context Protocol
• Raindrop.io API Documentation