Raindrop.io MCP Server
Connect Raindrop.io to your AI assistant with a simple MCP server. Use it to organize, search, and manage bookmarks with natural language.
Agenten stärken
Der eigene Befehl des Herausgebers. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
npx -y @adeze/[email protected]Claude Code hat keinen Installationslink für einen lokalen Befehl. Kopieren Sie den Befehl unten und führen Sie ihn in einem Terminal aus.
claude mcp add adeze-raindrop-mcp-npm -- npx -y @adeze/raindrop-mcp@3.0.0In einem Terminal ausführen.
{ "mcpServers": { "adeze-raindrop-mcp-npm": { "command": "npx", "args": [ "-y", "@adeze/[email protected]" ] } }}claude_desktop_config.json
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenRaindrop.io now also offers a hosted Streamable HTTP MCP endpoint (https://api.raindrop.io/rest/v2/ai/mcp) in beta for Pro users. Use that when its hosted toolset is sufficient; use this package for local stdio, self-hosted HTTP, and its additional library-management tools.
Note: For tools adding an MCP server via
npx, you must have theRAINDROP_ACCESS_TOKENenvironment variable set in your shell or the tool's environment config.
This project is compatible with the Vercel Skills system. All necessary manifests are present:
manifest.json: Standard MCP manifest for server definition.SKILL.md: Standardized skill description for agent discovery.mcp.json: Root configuration for MCP clients and registries.To add this server to your local skill directory:
npx skills add adeze/raindrop-mcp --global
To contribute this to the Vercel Skills Registry, submit a Pull Request adding this repository URL to the registry.
Download the latest raindrop-mcp.mcpb from the GitHub Release and add it to Claude Desktop:
In Claude Desktop, add the bundle and set this environment variable:
Set your API token as an environment variable and run:
export RAINDROP_ACCESS_TOKEN=YOUR_RAINDROP_ACCESS_TOKEN
npx @adeze/raindrop-mcp
Add this to your MCP client configuration:
{
"servers": {
"raindrop": {
"type": "stdio",
"command": "npx",
"args": ["@adeze/raindrop-mcp@latest"],
"env": {
"RAINDROP_ACCESS_TOKEN": "YOUR_RAINDROP_ACCESS_TOKEN"
}
}
}
}
bun run start:http serves /mcp on 127.0.0.1:3002; set HTTP_PORT to
change the port. HTTP tools use the server's RAINDROP_ACCESS_TOKEN. Host and
Origin checks prevent DNS rebinding but do not authenticate callers. For remote
access, place an authenticated reverse proxy in front of the loopback endpoint.
This repository uses semantic-release as the only supported release flow.
master via .github/workflows/publish.yml after validation passes.semantic-release analyzes Conventional Commit messages, computes the next version, updates CHANGELOG.md, tags/releases on GitHub, and publishes npm..releaserc.json syncs manifest.json, mcp.json, and gemini-extension.json, then builds raindrop-mcp.mcpb so the GitHub Release includes the bundle.master. Leave dry_run enabled to preview a release; disable it to run semantic-release publishing.GITHUB_TOKEN is provided by GitHub Actions for release automation.publish.yml, including manual dry runs.NPM_TOKEN is not required for the standard CI release path.Use Node 24.15+ and Bun 1.4.3+. The published server requires Node 22.19+.
Vite+ 1.1 manages lint, formatting, type checks, tests, and packaging through
vite.config.ts; Bun remains the package manager.
bun install --frozen-lockfile
bun run check
bun run test
bun run test:coverage
bun run docs
bun run build runs vp pack, preserving build/index.js, build/server.js,
source maps, and bundled dependencies. Tests build first so package checks work
from a clean checkout. bun run dev and bun run dev:http retain Bun's server
watch mode; bunx vp run dev runs the same script. vp dev starts a Vite web
server and is not this MCP server's development command.
The server uses TypeScript 7.0.2. TypeDoc and OpenAPI type generation currently need the TypeScript 6 compiler
API, so tooling/compiler-api keeps its own TypeScript 6.0.3 dependency. Install from the
root; bun run docs still generates the existing documentation.
bun run update:deps refreshes dependencies while keeping coverage aligned with
Vite+'s bundled Vitest 5.0.3. Update those pins together when upgrading Vite+.
The migration removed the generated clearMocks: false setting after the same
61 tests passed with Vitest 5 defaults. Coverage resolves the same 16 files as
Vitest 4; no thresholds or exclusions were relaxed. No tsdown compatibility
settings were needed because the original build used Bun.
The unused Java/Axios generator stack was removed; typed openapi-fetch remains
the shared client. Both current OpenAPI generators tested require the older
TypeScript compiler API: Hey API 0.99.0 fails under TypeScript 7 before CLI help.
The isolated, tested generator avoids changes to authentication, rate limiting
and cache behavior.
Release tooling still pulls braces 3.0.3, affected by
GHSA-vfj7-8cjw-p6xm;
no patched version is published. This dependency is not included in the server
bundle. Do not feed untrusted glob patterns to release tooling.
confirm: true. Cleanup tools keep their existing preview flow.127.0.0.1; OAuth callbacks require matching, unexpired,
single-use browser state. Remote access requires an authenticated proxy.collectionId; omit URL/title when changing only
other fields. Collection 0 means All and cannot be used for bulk mutations;
-1 means Unsorted.These fixes address the substance of PR #52 and issues #54/#55. Older SDK v1/Zod 3 migrations are superseded by this SDK v2 setup. Framework replacement was unnecessary: existing SDK APIs and shared service helpers eliminated redundant code. Live Raindrop mutations and OAuth provider login remain manual validation steps.
fix: handle empty tag merge payloadfeat: add collection path filterfeat!: remove deprecated search parameterDo not manually bump versions, push release tags, or run manual npm publish commands for normal releases.
get_suggestions tool provides organizational advice using Raindrop's API and MCP Sampling.get_collection_tree tool provides a hierarchical view with full breadcrumb paths.move operation to bulk_edit_raindrops for efficient library organization.list_raindrops and bookmark_search with pagination for large libraries.empty_trash, cleanup_collections) now require explicit confirmation.resource content following current MCP SDK best practicesmcp://raindrop/{id})mcp://collection/{id} and mcp://raindrop/{id}Apologies to anyone affected by the last couple of builds. Thank you for the patience and reports.
This project is licensed under the MIT License - see the LICENSE file for details.
MCP Server for Raindrop.io bookmark management
{ "mcpServers": { "adeze-raindrop-mcp-npm": { "command": "npx", "args": [ "-y", "@adeze/[email protected]" ] } }}Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
@adeze/raindrop läuft lokal über stdio.
Zuletzt geprüft: 2026-11-16. MCP Server for Raindrop.io bookmark management