raindrop-mcp

A Raindrop.io MCP server in Python (FastMCP), serving streamable HTTP natively — no stdio↔HTTP bridge needed. Also runs as a plain stdio server for clients that spawn a local process.

Built as a drop-in replacement for @adeze/raindrop-mcp: the 17 tools keep the same names, parameters, and required fields, so existing prompts and client configs keep working. (Two tools differ internally: get_suggestions / suggest_tags use Raindrop's native suggest endpoint rather than MCP-sampling-based AI refinement.)

Tools

Collection IDs: 0 = all, -1 = Unsorted, -99 = Trash. Destructive sweeps default to a dry run.

Related MCP server: Raindrop.io

Setup

Requires Python ≥ 3.10 and uv.

uv sync
cp config/.env.example config/.env   # then paste your token

Get a token at raindrop.io → Settings → Integrations → For Developers → create an app → Test token. Set it as RAINDROP_ACCESS_TOKEN in config/.env (or in the process environment, which takes precedence).

Running

Streamable HTTP (network clients — Claude Desktop remote MCP, gateways):

MCP_TRANSPORT=http MCP_PORT=8591 uv run start
# serves http://0.0.0.0:8591/mcp

stdio (clients that spawn the server locally):

uv run start

systemd user unit (example)

[Unit]
Description=Raindrop.io MCP (native FastMCP HTTP)
After=network.target

[Service]
Type=simple
WorkingDirectory=%h/raindrop-mcp
Environment=MCP_TRANSPORT=http
Environment=MCP_HOST=0.0.0.0
Environment=MCP_PORT=8591
ExecStart=%h/raindrop-mcp/.venv/bin/start
MemoryMax=512M
MemorySwapMax=0
Restart=always
RestartSec=5

[Install]
WantedBy=default.target

The server binds 0.0.0.0 in the example — front it with your LAN/VPN (Tailscale works well); the Raindrop token authorizes every request it serves.

Notes

• Scaffolded with mcp-template.

• Rate limiting: honours Retry-After once on HTTP 429 (Raindrop allows 120 req/min).

• skipCache parameters are accepted for compatibility but are no-ops — this server doesn't cache.

License

MIT