Raindrop.io MCP Server

by hiromitsusasaki
Verified
# 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 1. Clone the repository: ```bash git clone https://github.com/hiromitsusasaki/raindrop-io-mcp-server cd raindrop-io-mcp-server ``` 2. Install dependencies: ```bash 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: ```bash 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: ```json { "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 ```bash # 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](https://modelcontextprotocol.io/) - [Raindrop.io API Documentation](https://developer.raindrop.io/)