Raindrop.io

What is Raindrop.io MCP Server?

Raindrop.io MCP Server is an integration that enables Large Language Models (LLMs) to interact with Raindrop.io bookmarks through the Model Context Protocol (MCP). This allows LLMs to manage and access your saved bookmarks programmatically.

How to use Raindrop.io MCP Server?

There are two primary ways to install and use Raindrop.io MCP Server:

Installing via Smithery

For automatic installation with Claude Desktop, use the Smithery CLI:

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 add your Raindrop.io API token:

   RAINDROP_TOKEN=your_access_token_here
   

4. Build the project:

   npm run build
   

Using with Claude for Desktop

1. Open your 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, replacing PATH_TO_BUILD and your_access_token_here:

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

3. Restart Claude for Desktop.

Key Features of Raindrop.io MCP Server

• Create bookmarks: Add new URLs to your Raindrop.io collection.
• Search bookmarks: Find specific bookmarks using queries.
• Filter by tags: Refine search results by applying tags.
• Available Tools:
  • create-bookmark: Creates a new bookmark with parameters like url (required), title, tags, and collection.
  • search-bookmarks: Searches bookmarks with parameters like query (required) and tags.

Use Cases of Raindrop.io MCP Server

• Automated bookmark management: LLMs can automatically save articles, research papers, or web pages they process.
• Intelligent information retrieval: LLMs can search and retrieve specific bookmarks based on user queries or contextual needs.
• Personalized content curation: LLMs can help organize and tag bookmarks, making it easier to find relevant information later.
• Integration with AI assistants: Enhance AI assistants by giving them the ability to manage and access your web bookmarks.

FAQ about Raindrop.io MCP Server

Q: What are the requirements to run Raindrop.io MCP Server? A: You need Node.js 16 or higher and a Raindrop.io account with an API token.

Q: How do I get a Raindrop.io API token? A: You can generate an API token from your Raindrop.io account settings.

Q: Is this project open source? A: Yes, Raindrop.io MCP Server is an open-source project released under the MIT License. Contributions are welcome.

Q: What is the Model Context Protocol (MCP)? A: The Model Context Protocol is a standard that allows LLMs to interact with external services and data sources. More information can be found at modelcontextprotocol.io.

Q: How can I contribute to the project? A: You can contribute by submitting issues, feature requests, or pull requests on the project's GitHub repository.

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