🩺 Troubleshooting

🔌 Server not showing in Claude

1. Verify MCP_RAINDROPIO_TOKEN is set and non-empty.
2. Run npm install && npm run build (for local installations).
3. Check that the path in your config is absolute.
4. Restart Claude Desktop completely (Cmd+Q / Alt+F4).

🔐 Authentication errors

Test your token directly against the Raindrop.io API:

curl -H "Authorization: Bearer your-token-here" \
  https://api.raindrop.io/rest/v1/user

If this returns your user info, the token is valid. If not, regenerate it from app.raindrop.io/settings/integrations.

📋 Checking logs

Claude Desktop:

• macOS: ~/Library/Logs/Claude/mcp*.log
• Windows: %APPDATA%\Claude\logs\mcp*.log

Claude Code CLI:

claude mcp get raindrop

🔒 Security best practices

• Always use the MCP_RAINDROPIO_TOKEN env var — never hardcode tokens.
• Never commit your token to version control.
• Protect your claude_desktop_config.json.
• Rotate your token from the Raindrop.io integrations settings if you suspect it has been exposed.