# @adeze/raindrop-mcp [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/adeze/raindrop-mcp  
**GitHub Stars:** 191  
**npm Downloads (last month):** 694  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/adeze-raindrop-mcp

## Description
MCP Server for Raindrop.io bookmark management

## Tools
Capabilities this server exposes over MCP:

- **diagnostics** — Diagnostics resource and runtime metadata.
- **collection_list** — Lists all Raindrop.io collections as a flat list.
- **get_collection_tree** — Returns a hierarchical view of all collections with full breadcrumb paths.
- **collection_manage** — Creates, updates, or deletes a collection. Use the operation parameter to specify the action.
- **bookmark_search** — Searches bookmarks with advanced filters, tags, and full-text search.
- **bookmark_manage** — Creates, updates, or deletes bookmarks. Use the operation parameter to specify the action.
- **get_raindrop** — Fetch a single Raindrop.io bookmark by ID.
- **list_raindrops** — List Raindrop.io bookmarks for a collection with pagination.
- **tag_manage** — Renames, merges, or deletes tags. Use the operation parameter to specify the action.
- **highlight_manage** — Creates, updates, or deletes highlights. Use the operation parameter to specify the action.
- **bulk_edit_raindrops** — Bulk update, move, or remove bookmarks in a specific collection.
- **library_audit** — Scans the entire library for broken links and duplicate bookmarks.
- **empty_trash** — Permanently delete all bookmarks currently in the trash collection. Requires 'confirm: true' to execute.
- **cleanup_collections** — Remove all collections that do not contain any bookmarks. Requires 'confirm: true' to execute.
- **remove_duplicates** — Optimized duplicate deletion pattern. Scans all collections and removes duplicates in batches of 50 to minimize round-trips. Supports dry run to report counts without deleting.
- **get_suggestions** — Get AI-powered suggestions for tags and collections for a specific URL or existing bookmark.
- **suggest_tags** — Uses AI to suggest relevant tags based on bookmark metadata (title, URL, description).

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "raindrop-mcp": {
    "command": "npx",
    "args": ["-y","@adeze/raindrop-mcp"],
    "env": {
      "RAINDROP_ACCESS_TOKEN": "",
      "HTTP_PORT": ""
    }
  }
}
```

**Requires environment variables:** `RAINDROP_ACCESS_TOKEN`, `HTTP_PORT` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What @adeze/raindrop-mcp does

@adeze/raindrop-mcp exposes Raindrop.io library operations as MCP tools. An assistant can browse collections, search bookmarks with filters and pagination, retrieve individual items, and list bookmarks within a collection. It can also create, modify, or delete bookmarks and collections.

The server covers library maintenance as well as everyday bookmark management. Available operations include renaming, merging, and deleting tags; creating, updating, and deleting highlights; bulk changes within a collection; and audits for broken links, duplicates, and untagged items. Cleanup tools can remove duplicate bookmarks, empty collections, or the contents of trash, with confirmation safeguards for destructive actions.

## How it works

Authentication uses a Raindrop.io API access token supplied through `RAINDROP_ACCESS_TOKEN`. The package can run as a local stdio process, which is suitable for MCP clients that launch commands, or as an HTTP service. The HTTP mode serves the MCP endpoint at `/mcp` and listens on `127.0.0.1:3002` by default; `HTTP_PORT` changes the port.

HTTP host and Origin checks help prevent DNS rebinding, but the endpoint does not authenticate callers. Exposing it beyond the local machine therefore requires an authenticated reverse proxy. The package also includes manifests and installation paths for MCP clients, Vercel Skills, and a Claude Desktop MCPB bundle.

## Setup and configuration

You need a Raindrop.io account and an API access token from Raindrop.io's integrations settings. For an npm-based stdio setup, configure the server command with `npx` and pass the token in the process environment:

```json
{
  "servers": {
    "raindrop": {
      "type": "stdio",
      "command": "npx",
      "args": ["@adeze/raindrop-mcp@latest"],
      "env": {
        "RAINDROP_ACCESS_TOKEN": "YOUR_RAINDROP_ACCESS_TOKEN"
      }
    }
  }
}
```

The package can also be started directly with `npx @adeze/raindrop-mcp` after exporting the token. Gemini CLI, Codex CLI, and Claude Code have documented one-command installation paths. Claude Desktop users can install the latest `.mcpb` bundle from the project's GitHub releases and then set the same token.

## Tools and capabilities

- Inspect server diagnostics and library health metrics.
- List collections either as a flat list or as a tree with breadcrumb paths.
- Search, fetch, list, create, update, delete, and bulk-edit bookmarks.
- Generate organization suggestions and tag suggestions for bookmark metadata.
- Manage tags and highlights.
- Audit broken links, duplicates, and untagged bookmarks.
- Empty trash, remove empty collections, and remove duplicate bookmarks with confirmation flows.

## Limitations and notes

Raindrop.io's hosted Streamable HTTP MCP endpoint is a separate beta option for Pro users. This package remains useful for local stdio, self-hosted HTTP, and its additional library-management tools. Deletion of bookmarks, collections, tags, and highlights requires `confirm: true`; cleanup operations retain preview and confirmation behavior. Remote HTTP use should be protected by an authenticated reverse proxy.

_Full upstream README: https://allmcps.com/mcp/adeze-raindrop-mcp/readme_

