{"id":31684586,"url":"https://github.com/bitterpanda63/raindrop-mcp-server","last_synced_at":"2026-05-16T11:31:45.990Z","repository":{"id":317595847,"uuid":"1068065378","full_name":"bitterpanda63/raindrop-mcp-server","owner":"bitterpanda63","description":"A Model Context Protocol (MCP) server for Raindrop.io bookmarks, collections, tags, and more","archived":false,"fork":false,"pushed_at":"2025-10-01T20:04:37.000Z","size":23,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-01T22:07:46.680Z","etag":null,"topics":["ai","mcp","mcp-server","raindrop","raindrop-io"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bitterpanda63.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-01T19:58:14.000Z","updated_at":"2025-10-01T20:04:40.000Z","dependencies_parsed_at":"2025-10-01T22:07:50.678Z","dependency_job_id":"5afa991b-8a64-4c83-9902-7b294b503667","html_url":"https://github.com/bitterpanda63/raindrop-mcp-server","commit_stats":null,"previous_names":["bitterpanda63/raindrop-mcp-server"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/bitterpanda63/raindrop-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitterpanda63%2Fraindrop-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitterpanda63%2Fraindrop-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitterpanda63%2Fraindrop-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitterpanda63%2Fraindrop-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bitterpanda63","download_url":"https://codeload.github.com/bitterpanda63/raindrop-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitterpanda63%2Fraindrop-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278909752,"owners_count":26066899,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","mcp","mcp-server","raindrop","raindrop-io"],"created_at":"2025-10-08T08:10:20.108Z","updated_at":"2025-10-08T08:12:07.730Z","avatar_url":"https://github.com/bitterpanda63.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Raindrop MCP Server\n\nA Model Context Protocol (MCP) server for [Raindrop.io](https://raindrop.io) bookmark management. This server enables AI assistants to interact with your Raindrop.io bookmarks, collections, tags, and more through the MCP protocol.\n\n## Features\n\n- **Raindrops (Bookmarks)**: Create, read, update, and delete bookmarks with automatic pagination\n- **Collections**: Manage bookmark collections and nested hierarchies\n- **Tags**: View and manage tags across your bookmarks\n- **User**: Access authenticated user information\n- **Highlights**: Create and manage highlights on bookmarks\n- **Filters**: Access filtering options for your collections\n\n## Prerequisites\n\n- Node.js 18 or higher\n- A Raindrop.io account\n- Raindrop.io **test** Access token ([Get your token here](https://app.raindrop.io/settings/integrations))\n\n## Installation\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/bitterpanda63/raindrop-mcp-server.git\ncd raindrop-mcp-server\n```\n\n2. Install dependencies:\n```bash\nnpm install\n```\n\n3. Create a `.env` file in the root directory:\n```bash\nRAINDROP_TOKEN=your_raindrop_api_token_here\n```\n\n4. Build the project:\n```bash\nnpm run build\n```\n\n## Usage\n\n### Running the Server\n\nStart the MCP server:\n```bash\nnpm start\n```\n\n### Testing with MCP Inspector\n\nTest the server using the MCP Inspector:\n```bash\nnpx @modelcontextprotocol/inspector node dist/index.js\n```\n\nThis will open a web interface where you can test all available tools.\n\n### Using with Claude Desktop\n\nAdd to your Claude Desktop configuration file:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"raindrop\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/raindrop-mcp/dist/index.js\"],\n      \"env\": {\n        \"RAINDROP_TOKEN\": \"your_raindrop_api_token_here\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\n### Raindrops (Bookmarks)\n- `get_raindrops` - Get all raindrops from a collection (with automatic pagination)\n- `get_raindrop` - Get a single raindrop by ID\n- `create_raindrop` - Create a new bookmark\n- `update_raindrop` - Update an existing bookmark\n- `delete_raindrop` - Delete a bookmark\n\n### Collections\n- `get_collections` - Get root collections\n- `get_child_collections` - Get child collections\n- `get_collection` - Get a single collection by ID\n- `create_collection` - Create a new collection\n- `update_collection` - Update a collection\n- `delete_collection` - Delete a collection\n\n### Tags\n- `get_tags` - Get all tags\n- `delete_tag` - Delete a tag\n\n### User\n- `get_user` - Get authenticated user information\n\n### Highlights\n- `get_highlights` - Get highlights for a raindrop\n- `create_highlight` - Create a highlight\n- `delete_highlight` - Delete a highlight\n\n### Filters\n- `get_filters` - Get filters for a collection\n- `get_suggested_filters` - Get suggested filters\n\n## Development\n\nRun in development mode with auto-rebuild:\n```bash\nnpm run dev\n```\n\n## API Documentation\n\nFor detailed information about the Raindrop.io API, visit the [official documentation](https://developer.raindrop.io).\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitterpanda63%2Fraindrop-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbitterpanda63%2Fraindrop-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitterpanda63%2Fraindrop-mcp-server/lists"}