raindrop-io

This MCP server enables LLMs to interact with Raindrop.io bookmarks through the Model Context Protocol. It supports creating new bookmarks, searching bookmarks, and filtering results by tags. After starting the server, you can connect to it via MCP clients (such as Claude Desktop) and invoke the available tools to manage your Raindrop.io collection programmatically. The server expects an API token to authenticate with Raindrop.io, which you pass via the RAINDROP_TOKEN environment variable.

Available tools include:

• create-bookmark: Creates a new bookmark with fields like url, title, tags, and collection. This is useful for saving references surfaced by the LLM during a chat.
• search-bookmarks: Queries your Raindrops using a text query and optional tag filters. This helps fetch relevant bookmarks to reference in conversations or to retrieve context.

To use these tools, provide the required parameters (e.g., url for create-bookmark, query for search-bookmarks) and optional fields like title, tags, or collection. Ensure the RAINDROP_TOKEN is set in the runtime environment when the MCP server starts so the server can authenticate with Raindrop.io on behalf of your account.

Prerequisites:\n- Node.js 16 or higher\n- Git\n- Internet access to install dependencies\n\nStep-by-step installation:\n1. Clone the repository:\nbash\ngit clone https://github.com/hiromitsusasaki/raindrop-io-mcp-server.git\ncd raindrop-io-mcp-server\n\n2. Install dependencies:\nbash\nnpm install\n\n3. Set up environment variables:\n- Create a .env file in the project root and set your Raindrop.io API token:\nbash\nRAINDROP_TOKEN=your_access_token_here\n\n4. Build the project:\nbash\nnpm run build\n\n5. Start the server:\nbash\nnpm start\n\n\nNotes:\n- The README mentions a Smithery install option, but this guide covers manual setup.\n- Ensure your Node.js version matches the requirements (Node.js 16+).

Environment variables and configuration tips:\n- RAINDROP_TOKEN is required for authentication with Raindrop.io. Do not expose it in public configurations.\n- When using Claude Desktop, ensure the path in PATH_TO_BUILD/index.js points to the built server entry (from npm run build).\n- If you encounter authentication errors, double-check that RAINDROP_TOKEN is valid and has permissions to read and create bookmarks in Raindrop.io.\n- Build artifacts are typically placed in a build/output path; adjust PATH_TO_BUILD to reflect the actual output location after npm run build.\n- For production deployments, consider proper process management (e.g., using pm2 or systemd) and secure environment handling.