📦 Installation

Per-client setup for Claude Code CLI, Claude Desktop, Cursor, Windsurf, and VSCode.

✅ Prerequisites

Node.js 20+
A Raindrop.io account
A Raindrop.io API token — see Authentication

You can run the server two ways:

Via npx (no install needed):

npx --yes @kud/mcp-raindrop-io@latest

Local installation:

git clone https://github.com/kud/mcp-raindrop-io.git
cd mcp-raindrop-io
npm install
npm run build

🖥️ Claude Code CLI

Via npm:

claude mcp add --transport stdio --scope user raindrop \
  --env MCP_RAINDROPIO_TOKEN=your-token-here \
  -- npx --yes @kud/mcp-raindrop-io@latest

Local installation:

claude mcp add --transport stdio --scope user raindrop \
  --env MCP_RAINDROPIO_TOKEN=your-token-here \
  -- node $HOME/Projects/mcp-raindrop-io/dist/index.js

Verify with claude mcp list — it should show raindrop.

🪟 Claude Desktop

Open the configuration file.

macOS:

open ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows:

notepad %APPDATA%\Claude\claude_desktop_config.json

Add the server. Via npm (recommended):

{
  "mcpServers": {
    "Raindrop": {
      "command": "npx",
      "args": ["--yes", "@kud/mcp-raindrop-io@latest"],
      "env": {
        "MCP_RAINDROPIO_TOKEN": "your-token-here"
      }
    }
  }
}

Local installation:

{
  "mcpServers": {
    "Raindrop": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-raindrop-io/dist/index.js"],
      "env": {
        "MCP_RAINDROPIO_TOKEN": "your-token-here"
      }
    }
  }
}

Then quit (Cmd+Q / Alt+F4) and reopen Claude Desktop.

⌨️ Cursor

Settings (Cmd+, / Ctrl+,) → search "MCP" → Edit Config, or open ~/.cursor/mcp_config.json:

{
  "mcpServers": {
    "raindrop": {
      "command": "npx",
      "args": ["--yes", "@kud/mcp-raindrop-io@latest"],
      "env": {
        "MCP_RAINDROPIO_TOKEN": "your-token-here"
      }
    }
  }
}

Restart Cursor after configuration.

🏄 Windsurf

Settings → AI Settings → Model Context Protocol → Add Server:

{
  "mcpServers": {
    "raindrop": {
      "command": "npx",
      "args": ["--yes", "@kud/mcp-raindrop-io@latest"],
      "env": {
        "MCP_RAINDROPIO_TOKEN": "your-token-here"
      }
    }
  }
}

Restart Windsurf after configuration.

🧩 VSCode (Cline / Claude Dev)

Settings → search "Cline: MCP Settings" → edit in settings.json:

{
  "cline.mcpServers": {
    "raindrop": {
      "command": "npx",
      "args": ["--yes", "@kud/mcp-raindrop-io@latest"],
      "env": {
        "MCP_RAINDROPIO_TOKEN": "your-token-here"
      }
    }
  }
}

Reload the window after configuration.

📦 Installation

✅ Prerequisites

🖥️ Claude Code CLI

🪟 Claude Desktop

⌨️ Cursor

🏄 Windsurf

🧩 VSCode (Cline / Claude Dev)

On this page