👋 Introduction

mcp-raindrop-io is a Model Context Protocol server that gives AI assistants full control over your Raindrop.io library — bookmarks, collections, tags, and highlights — through 23 typed tools.

Save a URL by asking. Search your library in natural language. Audit for broken links and duplicates. Rename a tag everywhere at once. It all runs locally over the MCP stdio transport, authenticated with a single token.

✨ Features

• Simple auth — one Bearer token via the MCP_RAINDROPIO_TOKEN env var.
• 23 tools — full coverage of bookmarks, collections, tags, highlights, and library utilities.
• Bookmark management — create, search, update, delete, and bulk-edit with advanced filters.
• Collection control — root and nested collections, full CRUD, and cleanup of empty collections.
• Tag operations — list, rename, merge, and delete tags globally or per collection.
• Highlights — create and manage text highlights on bookmarks.
• Smart search — filter by broken links, duplicates, untagged, domain, media type, and date range.
• Library utilities — audit your library, empty the trash, and clean up empty collections.
• Modern stack — TypeScript 5+, ES2023, native Fetch, ESM, MCP 1.0.

🔐 Authentication

Every request is authenticated with a single Raindrop.io test token.

1. Go to app.raindrop.io/settings/integrations.
2. Click Create new app.
3. Give it a name (e.g. "MCP Server").
4. Open the app and copy the Test token.

Paste it into the MCP_RAINDROPIO_TOKEN environment variable wherever you configure the server.

Keep your token private. It grants full read/write access to your Raindrop.io account. Never commit it to version control, and rotate it from the integrations settings if you suspect it has been exposed.

🚀 Quick start

The fastest path is npx — no install needed:

npx --yes @kud/mcp-raindrop-io@latest

Then add it to Claude Desktop's config:

{
  "mcpServers": {
    "Raindrop": {
      "command": "npx",
      "args": ["--yes", "@kud/mcp-raindrop-io@latest"],
      "env": {
        "MCP_RAINDROPIO_TOKEN": "your-token-here"
      }
    }
  }
}

Restart Claude Desktop and start saving bookmarks with AI.

For per-client setup (Claude Code CLI, Cursor, Windsurf, VSCode), see Installation. For the full tool reference, start with Bookmark tools.

💬 Example conversations

Once configured, manage your bookmarks naturally:

You: "Save this URL to my Reading List collection: https://example.com/article"
AI: *Creates the bookmark and confirms*

You: "Find all my bookmarks about TypeScript"
AI: *Searches and returns matching bookmarks*

You: "Show me all my broken links"
AI: *Lists all bookmarks with broken links*

You: "Move all bookmarks tagged 'draft' to my Archive collection"
AI: *Bulk moves bookmarks*

You: "Rename the tag 'js' to 'javascript' across all my collections"
AI: *Renames the tag globally*

You: "Audit my library — how many duplicates and untagged items do I have?"
AI: *Returns counts for broken, duplicates, and untagged*