https://github.com/hiromitsusasaki/raindrop-io-mcp-server
An integration that allows LLMs to interact with Raindrop.io bookmarks using the Model Context Protocol (MCP).
https://github.com/hiromitsusasaki/raindrop-io-mcp-server
modelcontextprotocol raindrop-io
Last synced: 25 days ago
JSON representation
An integration that allows LLMs to interact with Raindrop.io bookmarks using the Model Context Protocol (MCP).
- Host: GitHub
- URL: https://github.com/hiromitsusasaki/raindrop-io-mcp-server
- Owner: hiromitsusasaki
- Created: 2025-01-10T15:53:22.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-03-09T13:28:35.000Z (about 1 month ago)
- Last Synced: 2025-03-09T14:25:16.162Z (about 1 month ago)
- Topics: modelcontextprotocol, raindrop-io
- Language: TypeScript
- Homepage:
- Size: 5.86 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - hiromitsusasaki/raindrop-io-mcp-server - An integration that allows LLMs to interact with Raindrop.io bookmarks using the Model Context Protocol (MCP). (Legend / 🛠️ <a name="other-tools-and-integrations"></a>Other Tools and Integrations)
- awesome-mcp-servers - hiromitsusasaki/raindrop-io-mcp-server - An integration that allows LLMs to interact with Raindrop.io bookmarks using the Model Context Protocol (MCP). (Legend / 🛠️ <a name="other-tools-and-integrations"></a>Other Tools and Integrations)
- awesome-mcp-servers - Raindrop MCP Server - An integration that allows LLMs to interact with Raindrop.io bookmarks using the Model Context Protocol (MCP). (Table of Contents / AI Services)
- awesome-mcp-servers - Raindrop MCP Server - An integration that allows LLMs to interact with Raindrop.io bookmarks using the Model Context Protocol (MCP). (Table of Contents / AI Services)
README
# Raindrop.io MCP Server
An integration that allows LLMs to interact with Raindrop.io bookmarks using the Model Context Protocol (MCP).
## Features
- Create bookmarks
- Search bookmarks
- Filter by tags
## Requirements
- Node.js 16 or higher
- Raindrop.io account and API token
## Setup
1. Clone the repository:
```bash
git clone https://github.com/hiromitsusasaki/raindrop-io-mcp-server
cd raindrop-io-mcp-server
```
2. Install dependencies:
```bash
npm install
```
3. Set up environment variables:
- Create a `.env` file and set your Raindrop.io API token
```
RAINDROP_TOKEN=your_access_token_here
```
4. Build:
```bash
npm run build
```
## Using with Claude for Desktop
1. Open Claude for Desktop configuration file:
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
2. Add the following configuration:
```json
{
"mcpServers": {
"raindrop": {
"command": "node",
"args": ["PATH_TO_BUILD/index.js"],
"env": {
"RAINDROP_TOKEN": "your_access_token_here"
}
}
}
}
```
3. Restart Claude for Desktop
## Available Tools
### create-bookmark
Creates a new bookmark.
**Parameters:**
- `url`: URL to bookmark (required)
- `title`: Title for the bookmark (optional)
- `tags`: Array of tags (optional)
- `collection`: Collection ID (optional)
### search-bookmarks
Searches through bookmarks.
**Parameters:**
- `query`: Search query (required)
- `tags`: Array of tags to filter by (optional)
## Development
```bash
# Build for development
npm run build
# Start server
npm start
```
## Security Notes
- Always manage API tokens using environment variables
- Set appropriate permissions for Claude for Desktop configuration files
- Restrict unnecessary file access
## Open Source
This is an open source MCP server that anyone can use and contribute to. The project is released under the MIT License.
## Contributing
Contributions are welcome! Feel free to submit issues, feature requests, or pull requests to help improve this project.
## Related Links
- [Model Context Protocol](https://modelcontextprotocol.io/)
- [Raindrop.io API Documentation](https://developer.raindrop.io/)