Raindrop Io MCP Server

🚀 Raindrop.io MCP Server

An integration that allows Large Language Models (LLMs) to interact with Raindrop.io bookmarks via the Model Context Protocol (MCP).

🚀 Quick Start

This integration enables LLMs to interact with Raindrop.io bookmarks, offering functions such as creating, searching, and filtering bookmarks.

✨ Features

• Create bookmarks
• Search bookmarks
• Filter by tags

📦 Installation

Install via Smithery

Automatically install the Raindrop.io integration through 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 environment variables:

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

RAINDROP_TOKEN=your_access_token_here

4. Build:

npm run build

💻 Usage Examples

Use with Claude Desktop

1. Open the Claude 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 Desktop

Available Tools

create-bookmark

Create a new bookmark.

Parameters:

• url: The URL to bookmark (required)
• title: The title of the bookmark (optional)
• tags: An array of tags (optional)
• collection: The collection ID (optional)

search-bookmarks

Search for bookmarks.

Parameters:

• query: The search query (required)
• tags: An array of tags for filtering (optional)

🔧 Technical Details

Development

# Build for development
npm run build

# Start the server
npm start

📚 Documentation

Security Considerations

• Always manage API tokens using environment variables.
• Set appropriate file permissions.
• Limit 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.

Contribution

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

Related Links

• Model Context Protocol
• Raindrop.io API Documentation