{
  "markdown": "# Raindrop.io MCP Server\n\n[![smithery badge](https://smithery.ai/badge/@adeze/raindrop-mcp)](https://smithery.ai/server/@adeze/raindrop-mcp)\n[![npm version](https://badge.fury.io/js/%40adeze%2Fraindrop-mcp.svg)](https://www.npmjs.com/package/@adeze/raindrop-mcp)\n[![Claude Desktop MCPB](https://img.shields.io/badge/Claude%20Desktop-MCPB-5B61FF?logo=claude&logoColor=white)](https://github.com/adeze/raindrop-mcp/releases)\n\nConnect Raindrop.io to your AI assistant with a simple MCP server. Use it to organize, search, and manage bookmarks with natural language.\n\n> Raindrop.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.\n\n## What it can do\n\n- Create, update, and delete collections and bookmarks\n- Search bookmarks by tags, domain, type, date, and more\n- Manage tags (list, rename, merge, delete)\n- Read highlights from bookmarks\n- Bulk edit bookmarks in a collection\n- Audit broken links and duplicates, and manage trash\n\n## Tools\n\n- **diagnostics** - Server diagnostic information and library health metrics\n- **collection_list** - List all collections as a flat list\n- **get_collection_tree** - Hierarchical view of collections with full breadcrumb paths\n- **collection_manage** - Create, update, or delete collections\n- **bookmark_search** - Advanced search with filters, tags, and pagination\n- **bookmark_manage** - Create, update, or delete bookmarks\n- **get_raindrop** - Fetch a single bookmark by ID\n- **list_raindrops** - List bookmarks for a collection with pagination\n- **get_suggestions** - AI-powered organization advice (tags/collections) for a URL or bookmark\n- **suggest_tags** - Suggest relevant tags from bookmark metadata using AI-assisted analysis\n- **bulk_edit_raindrops** - Bulk update, move, or remove bookmarks in a specific collection\n- **tag_manage** - Rename, merge, or delete tags\n- **highlight_manage** - Create, update, or delete highlights\n- **library_audit** - Scan library for broken links, duplicates, and untagged items\n- **empty_trash** - Permanently empty the trash (requires confirmation)\n- **cleanup_collections** - Remove empty collections (requires confirmation)\n- **remove_duplicates** - Find and remove duplicate bookmarks with safe confirmation flow\n\n## Install\n\n### Quick Start (One-Liners)\n\n| Tool               | One-Liner Command                                                  |\n| :----------------- | :----------------------------------------------------------------- |\n| **Gemini CLI**     | `gemini extensions install https://github.com/adeze/raindrop-mcp`  |\n| **Codex CLI**      | `codex mcp add raindrop -- npx -y @adeze/raindrop-mcp`             |\n| **Claude Code**    | `claude mcp add raindrop -- npx -y @adeze/raindrop-mcp`            |\n| **GitHub Copilot** | `gh copilot config mcp add raindrop -- npx -y @adeze/raindrop-mcp` |\n| **Vercel Skills**  | `npx skills add adeze/raindrop-mcp`                                |\n\n> **Note**: For tools adding an MCP server via `npx`, you must have the `RAINDROP_ACCESS_TOKEN` environment variable set in your shell or the tool's environment config.\n\n### Vercel Skills (npx skills)\n\nThis project is compatible with the [Vercel Skills](https://github.com/vercel/skills) system. All necessary manifests are present:\n\n- `manifest.json`: Standard MCP manifest for server definition.\n- `SKILL.md`: Standardized skill description for agent discovery.\n- `mcp.json`: Root configuration for MCP clients and registries.\n\nTo add this server to your local skill directory:\n\n```bash\nnpx skills add adeze/raindrop-mcp --global\n```\n\nTo contribute this to the [Vercel Skills Registry](https://github.com/vercel/skills/tree/main/registry), submit a Pull Request adding this repository URL to the registry.\n\n### Claude Desktop (MCPB)\n\nDownload the latest raindrop-mcp.mcpb from the GitHub Release and add it to Claude Desktop:\n\n- Releases: https://github.com/adeze/raindrop-mcp/releases\n\nIn Claude Desktop, add the bundle and set this environment variable:\n\n- RAINDROP_ACCESS_TOKEN (from your Raindrop.io integrations settings)\n\n### NPX (CLI)\n\nSet your API token as an environment variable and run:\n\n```bash\nexport RAINDROP_ACCESS_TOKEN=YOUR_RAINDROP_ACCESS_TOKEN\nnpx @adeze/raindrop-mcp\n```\n\n### Manual MCP config (mcp.json)\n\nAdd this to your MCP client configuration:\n\n```json\n{\n  \"servers\": {\n    \"raindrop\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"@adeze/raindrop-mcp@latest\"],\n      \"env\": {\n        \"RAINDROP_ACCESS_TOKEN\": \"YOUR_RAINDROP_ACCESS_TOKEN\"\n      }\n    }\n  }\n}\n```\n\n## Requirements\n\n- A Raindrop.io account\n- A Raindrop.io API Access Token: https://app.raindrop.io/settings/integrations\n\n## Support\n\n- Issues: https://github.com/adeze/raindrop-mcp/issues\n\n## Release\n\nThis repository uses `semantic-release` as the only supported release flow.\n\n### How publishing works\n\n- Releases run from pushes to `master` via `.github/workflows/ci.yml`.\n- `semantic-release` analyzes Conventional Commit messages, computes the next version, updates `CHANGELOG.md`, tags/releases on GitHub, and publishes npm.\n- During release preparation, `.releaserc.json` syncs `manifest.json`, `mcp.json`, and `gemini-extension.json`, then builds `raindrop-mcp.mcpb` so the GitHub Release includes the bundle.\n\n### Pre-release dry-run\n\n- Run `.github/workflows/release-dry-run.yml` with **Run workflow** before cutting a public release.\n- This validates semantic version calculation, registry auth, and release pipeline behavior without publishing.\n\n### Required secrets\n\n- `GITHUB_TOKEN` is provided by GitHub Actions for release automation.\n\n### npm trusted publishing\n\n- npm publishing is configured via GitHub Actions OIDC trusted publishing.\n- `NPM_TOKEN` is not required for the standard CI release path.\n\n### Local validation before merge\n\n```bash\nbun run lint\nbun run type-check\nbun run test\nbun run build\n```\n\n### Commit message examples\n\n- `fix: handle empty tag merge payload`\n- `feat: add collection path filter`\n- `feat!: remove deprecated search parameter`\n\nDo not manually bump versions, push release tags, or run manual npm publish commands for normal releases.\n\n## 📋 Recent Enhancements (v2.4.x)\n\n### Smart Organization & Hierarchy\n\n- **AI Suggestions**: New `get_suggestions` tool provides organizational advice using Raindrop's API and MCP Sampling.\n- **Collection Tree**: `get_collection_tree` tool provides a hierarchical view with full breadcrumb paths.\n- **Bulk Move**: Added `move` operation to `bulk_edit_raindrops` for efficient library organization.\n- **Pagination Support**: Standardized `list_raindrops` and `bookmark_search` with pagination for large libraries.\n\n### Safety & Quality\n\n- **Confirmation Logic**: Destructive tools (`empty_trash`, `cleanup_collections`) now require explicit confirmation.\n- **Standardized Naming**: All tools now use consistent snake_case naming conventions.\n- **CI/CD Pipeline**: Enhanced GitHub Actions with automated linting, type-checking, and cross-transport tests.\n- **Code Quality**: Established ESLint and Prettier configurations for maintainable development.\n\n## 📋 Previous Enhancements (v2.3.3)\n\n### Advanced Cleanup & Library Audit\n\n## 📋 Previous Enhancements (v2.3.2)\n\n### MCP Resource Links Implementation\n\n- Modern `resource` content following current MCP SDK best practices\n- Efficient data access: tools return lightweight links instead of full payloads\n- Better performance: clients fetch full bookmark/collection data only when needed\n- Seamless integration with dynamic resource system (`mcp://raindrop/{id}`)\n\n### SDK & API Updates\n\n- Updated to the latest supported MCP SDK in this repository\n- Modern tool registration with improved descriptions\n- Fixed API endpoints and path parameters\n- All core tools fully functional\n\n### Tool Optimization\n\n- Resource-efficient responses for bookmark/collection lists\n- Dynamic resource access via `mcp://collection/{id}` and `mcp://raindrop/{id}`\n- Better client UX with lighter list payloads\n- Full MCP compliance with official SDK patterns\n\n### Service Layer Improvements\n\n- Reduced code through extracted common helpers\n- Consistent error handling and response processing\n- Enhanced type safety with generic handlers\n- Centralized endpoint building\n\n### Testing Improvements\n\n- Stronger end-to-end coverage for MCP tool execution\n- Expanded integration tests for real-world client flows\n\n### MCP 2.0 Preparation (Bulk Ops)\n\n- Laying groundwork for MCP 2.0 bulk-operation workflows and tooling\n\n### OAuth (Coming Soon)\n\n- OAuth-based auth flow to simplify setup without manual tokens\n\n### Note\n\nApologies to anyone affected by the last couple of builds. Thank you for the patience and reports.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n",
  "bytes": 8951,
  "sha": "f76d17a40dd8cdecec620363088c928a0ebea7858dd8d3531735f171bb3caa76",
  "repo_slug": "adeze/raindrop-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_adeze_raindrop_mcp_dd62fdcc/readme"
}