Raindrop.io MCP Server

1# Raindrop.io MCP Server
2[![smithery badge](https://smithery.ai/badge/@hiromitsusasaki/raindrop-io-mcp-server)](https://smithery.ai/server/@hiromitsusasaki/raindrop-io-mcp-server)
3 
4An integration that allows LLMs to interact with Raindrop.io bookmarks using the Model Context Protocol (MCP).
5 
6<a href="https://glama.ai/mcp/servers/@hiromitsusasaki/raindrop-io-mcp-server">
7  <img width="380" height="200" src="https://glama.ai/mcp/servers/@hiromitsusasaki/raindrop-io-mcp-server/badge" alt="Raindrop.io Server MCP server" />
8</a>
9 
10## Features
11 
12- Create bookmarks
13- Search bookmarks
14- Filter by tags
15 
16## Requirements
17 
18- Node.js 16 or higher
19- Raindrop.io account and API token
20 
21## Setup
22 
23### Installing via Smithery
24 
25To install Raindrop.io Integration for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@hiromitsusasaki/raindrop-io-mcp-server):
26 
27```bash
28npx -y @smithery/cli install @hiromitsusasaki/raindrop-io-mcp-server --client claude
29```
30 
31### Manual Installation
32 
331. Clone the repository:
34```bash
35git clone https://github.com/hiromitsusasaki/raindrop-io-mcp-server
36cd raindrop-io-mcp-server
37```
38 
392. Install dependencies:
40```bash
41npm install
42```
43 
443. Set up environment variables:
45- Create a `.env` file and set your Raindrop.io API token
46```
47RAINDROP_TOKEN=your_access_token_here
48```
49 
504. Build:
51```bash
52npm run build
53```
54 
55## Using with Claude for Desktop
56 
571. Open Claude for Desktop configuration file:
58- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
59- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
60 
612. Add the following configuration:
62```json
63{
64  "mcpServers": {
65    "raindrop": {
66      "command": "node",
67      "args": ["PATH_TO_BUILD/index.js"],
68      "env": {
69        "RAINDROP_TOKEN": "your_access_token_here"
70      }
71    }
72  }
73}
74```
75 
763. Restart Claude for Desktop
77 
78## Available Tools
79 
80### create-bookmark
81Creates a new bookmark.
82 
83**Parameters:**
84- `url`: URL to bookmark (required)
85- `title`: Title for the bookmark (optional)
86- `tags`: Array of tags (optional)
87- `collection`: Collection ID (optional)
88 
89### search-bookmarks
90Searches through bookmarks.
91 
92**Parameters:**
93- `query`: Search query (required)
94- `tags`: Array of tags to filter by (optional)
95 
96## Development
97 
98```bash
99# Build for development
100npm run build
101 
102# Start server
103npm start
104```
105 
106## Security Notes
107 
108- Always manage API tokens using environment variables
109- Set appropriate permissions for Claude for Desktop configuration files
110- Restrict unnecessary file access
111 
112## Open Source
113 
114This is an open source MCP server that anyone can use and contribute to. The project is released under the MIT License.
115 
116## Contributing
117 
118Contributions are welcome! Feel free to submit issues, feature requests, or pull requests to help improve this project.
119 
120## Related Links
121 
122- [Model Context Protocol](https://modelcontextprotocol.io/)
123- [Raindrop.io API Documentation](https://developer.raindrop.io/)