> ## Documentation Index
> Fetch the complete documentation index at: https://help.raindrop.io/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP server

<Frame style={{padding: '48px'}}>
  <Icon icon="microchip" iconType="duotone" size={80} color="#7C3AED" />
</Frame>

The [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server provides a standardized interface that allows any compatible AI model or agent to access your Raindrop.io data in a simple and secure way.

## Server address

Our MCP server uses Streamable HTTP transport with OAuth 2.1 authentication at the following address:

```
https://api.raindrop.io/rest/v2/ai/mcp
```

On first connection your browser will open to authorize access to your Raindrop.io account.

## Supported clients

<CardGroup cols={1}>
  <Card title="Claude" icon="https://mintcdn.com/raindropio-0c6b7ca1/GdpCiIhWcEST3eHX/assets/icon-claude.png?fit=max&auto=format&n=GdpCiIhWcEST3eHX&q=85&s=d951ff5c71ec3560329f2469f657f43a" href="/integrations/claude" horizontal width="64" height="64" data-path="assets/icon-claude.png">
    claude.ai, Desktop, and Claude Code
  </Card>

  <Card title="ChatGPT" icon="openai" href="/integrations/chatgpt" horizontal>
    Plus, Pro, Business, Enterprise, Education
  </Card>

  <Card title="VS Code" icon="https://mintcdn.com/raindropio-0c6b7ca1/g7d24I8ROfahz7TM/assets/icon-vscode.png?fit=max&auto=format&n=g7d24I8ROfahz7TM&q=85&s=b05de90e9d3c005662c9eadb3188bfc2" href="/integrations/vscode" horizontal width="120" height="120" data-path="assets/icon-vscode.png">
    GitHub Copilot
  </Card>

  <Card title="Cursor" icon="https://mintcdn.com/raindropio-0c6b7ca1/g7d24I8ROfahz7TM/assets/icon-cursor.png?fit=max&auto=format&n=g7d24I8ROfahz7TM&q=85&s=1df8d38f4b98c0ec22c49a8759df8cfd" href="/integrations/cursor" horizontal width="180" height="180" data-path="assets/icon-cursor.png">
    AI code editor
  </Card>

  <Card title="Windsurf" icon="https://mintcdn.com/raindropio-0c6b7ca1/g7d24I8ROfahz7TM/assets/icon-windsurf.png?fit=max&auto=format&n=g7d24I8ROfahz7TM&q=85&s=8580884be9c04f116b02691b98ac817b" href="/integrations/windsurf" horizontal width="120" height="120" data-path="assets/icon-windsurf.png">
    AI code editor
  </Card>

  <Card title="Zed" icon="https://mintcdn.com/raindropio-0c6b7ca1/g7d24I8ROfahz7TM/assets/icon-zed.png?fit=max&auto=format&n=g7d24I8ROfahz7TM&q=85&s=06b8947c127b95ddc398aff6a400c0b6" href="/integrations/zed" horizontal width="120" height="120" data-path="assets/icon-zed.png">
    Code editor (via mcp-remote bridge)
  </Card>
</CardGroup>

## Other MCP clients

Hundreds of other tools now support MCP servers. You can configure them to use Raindrop.io MCP server with the following settings:

* **Command:** `npx`
* **Arguments:** `-y mcp-remote https://api.raindrop.io/rest/v2/ai/mcp`
* **Environment:** None

For cloud-based or other hosted clients not listed on this page, please reach out to [info@raindrop.io](mailto:info@raindrop.io) so we can enable support.

## Available tools

The server exposes the following tools. Read-only tools only fetch data; the rest modify your library.

### Bookmarks

| Tool                       | Description                                              | Read-only |
| -------------------------- | -------------------------------------------------------- | --------- |
| `find_bookmarks`           | Find bookmarks with filters and semantic search          | Yes       |
| `fetch_bookmark_content`   | Get full text and metadata of a bookmark                 | Yes       |
| `find_misplaced_bookmarks` | Detect bookmarks that don't fit their collection         | Yes       |
| `find_mistagged_bookmarks` | Detect bookmarks with unfitting tags                     | Yes       |
| `create_bookmarks`         | Save one or many URLs to the library                     |           |
| `update_bookmarks`         | Edit title, note, tags, collection and more              |           |
| `delete_bookmarks`         | Move to Trash, or delete permanently if already in Trash |           |

### Collections

| Tool                 | Description                                     | Read-only |
| -------------------- | ----------------------------------------------- | --------- |
| `find_collections`   | Find collections by name or bookmark count      | Yes       |
| `create_collections` | Create one or many collections                  |           |
| `update_collections` | Rename, edit description, or move collections   |           |
| `merge_collections`  | Merge source collections into a target          |           |
| `delete_collections` | Delete collections; their bookmarks go to Trash |           |

### Tags

| Tool          | Description                                | Read-only |
| ------------- | ------------------------------------------ | --------- |
| `find_tags`   | Find tags by exact name or semantic search | Yes       |
| `update_tags` | Rename or merge tags                       |           |
| `delete_tags` | Remove tags from the library               |           |

### Highlights

| Tool                | Description                         | Read-only |
| ------------------- | ----------------------------------- | --------- |
| `find_highlights`   | Find highlights across the library  | Yes       |
| `create_highlight`  | Add a highlight to a bookmark       |           |
| `update_highlight`  | Edit highlight text, note, or color |           |
| `delete_highlights` | Delete specific highlights          |           |

### Account

| Tool                     | Description                                        | Read-only |
| ------------------------ | -------------------------------------------------- | --------- |
| `fetch_current_user`     | Get profile, subscription, and library stats       | Yes       |
| `fetch_popular_keywords` | Get frequent keywords and domains across bookmarks | Yes       |

## FAQ

<AccordionGroup>
  <Accordion title="Why am I seeing an error when trying to connect?">
    Run the following in Terminal to clear saved auth info, then try again:

    ```bash theme={null}
    rm -rf ~/.mcp-auth
    ```

    If the issue persists, make sure you have the latest version of [Node.js](https://nodejs.org) installed.
  </Accordion>

  <Accordion title="Does the MCP support Streamable HTTP?">
    Yes, at the `https://api.raindrop.io/rest/v2/ai/mcp` endpoint. This is the only supported transport.
  </Accordion>

  <Accordion title="Can I authenticate with my own API keys or OAuth access tokens?">
    Yes. You can pass your [Raindrop.io API](https://developer.raindrop.io) token directly in the `Authorization: Bearer <your-token>` header instead of using the interactive OAuth flow.
  </Accordion>

  <Accordion title="I'm using WSL on Windows, and seeing an error">
    Try this configuration instead:

    ```json theme={null}
    {
    	"mcpServers": {
    		"raindrop": {
    			"command": "wsl",
    			"args": ["npx", "-y", "mcp-remote", "https://api.raindrop.io/rest/v2/ai/mcp"]
    		}
    	}
    }
    ```
  </Accordion>
</AccordionGroup>