# Raindrop MCP Server

Search and retrieve your curated bookmarks from [Raindrop.io](https://raindrop.io) directly in your AI-powered IDE (Antigravity, Cursor, VS Code, etc.).

## Features

- 🔍 Search your bookmarked tools, components, and resources
- 📋 List all bookmarks in a collection
- 📦 **New:** `search_bookmark_components` - Search UI/component libraries in your bookmarks for specific components and return deep links directly.
- 🎨 **New:** `extract_design_system` - Fetch any URL (or bookmark) and parse CSS variables, custom colors, fonts, and layout metadata to automatically map out its design system.
- 🌧️ Auto-updates when you add new bookmarks via browser extension
- 🔐 Secure credential storage
- 🚀 Works cross-platform (Linux, macOS, Windows)
- ⚡ Automatic IDE configuration

## Tools

### 1. `search_raindrop`
Search bookmarks in your Raindrop collection.
* **Arguments:** `query` (string)

### 2. `list_raindrop`
List all bookmarks in your Raindrop collection.
* **Arguments:** None

### 3. `search_bookmark_components`
Deep search matching component keywords (like "navbar", "carousel") inside your bookmarked UI libraries.
* **Arguments:**
  * `query` (string): The UI component name to find.
  * `collectionId` (string, optional): Raindrop collection ID (defaults to configured collection). Use `"0"` to search all collections.

### 4. `extract_design_system`
Extract colors, custom variables, fonts, and structural layout indicators from a website URL.
* **Arguments:**
  * `url` (string): The URL of the website to analyze.

## Quick Start

### 1. Install and Setup (Automatic)

You can install the package globally in a single step, which will automatically run the interactive setup wizard:

```bash
npm install -g @djrcx/raindrop-mcp
```

Or you can run the setup wizard on-demand using npx:

```bash
npx -p @djrcx/raindrop-mcp raindrop-mcp-setup
```