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.
Potencia tu agente
El comando propio del publicador. No es un endpoint de PlugMCP.
Host a copy with our keys and logs.
npx -y @adeze/[email protected]Claude Code no tiene enlace de instalación para un comando local. Copia el comando de abajo y ejecútalo en una terminal.
claude mcp add adeze-raindrop-mcp-npm -- npx -y @adeze/raindrop-mcp@3.0.0Ejecútalo en una terminal.
{ "mcpServers": { "adeze-raindrop-mcp-npm": { "command": "npx", "args": [ "-y", "@adeze/[email protected]" ] } }}claude_desktop_config.json
¿URL remota o un comando en tu máquina? En qué se diferencian las dos instalaciones
Ejecutar en PlugMCP
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.
AbrirRaindrop.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.
{ "mcpServers": { "adeze-raindrop-mcp-npm": { "command": "npx", "args": [ "-y", "@adeze/[email protected]" ] } }}Herramientas
Aún no hay lista de herramientas. Los servidores remotos la reciben tras la primera comprobación de estado.
Preguntas frecuentes
Copia en esta página la configuración stdio para Cursor, Claude Desktop, Claude Code o VS Code. Usa la instalación del publicador, no un proxy de PlugMCP.
Este registro no indica ninguna variable de entorno obligatoria.
@adeze/raindrop se ejecuta localmente por stdio.
Última comprobación: 2026-11-16. MCP Server for Raindrop.io bookmark management