Raindrop Skill

Raindrop.io Agent Skill

Manage your [Raindrop.io](https://raindrop.io) bookmarks with AI assistants.

Save links, organize collections, search bookmarks, add highlights—all through natural language.

Features

• Bookmarks — Create, search, update, bulk edit, import/export
• Collections — Organize, nest, share with collaborators
• Tags — Add, rename, merge across bookmarks
• Highlights — Save annotated snippets with colors
• Multi-client — Works with Claude Code, Codex, Amp, OpenCode

---

Quick Start

# 1. Get token from Raindrop
#    https://app.raindrop.io/settings/integrations
#    → Create app → Create test token

# 2. Add to shell
echo 'export RAINDROP_TOKEN="your_token"' >> ~/.zshrc.local
source ~/.zshrc

# 3. Install (Claude Code / Amp / OpenCode)
git clone https://github.com/gmickel/raindrop-skill ~/.claude/skills/raindrop

# 3. Install (Codex)
git clone https://github.com/gmickel/raindrop-skill ~/.codex/skills/raindrop

# 4. Use it
"Save this article to my Reading collection"
"Search my bookmarks for React hooks"
"List all tags in my Dev collection"

---

Setup

1. Create Raindrop App

1. Go to app.raindrop.io/settings/integrations
2. Click Create new app
3. Fill in:
   • Name: AI Assistant (or anything)
   • Redirect URI: http://localhost (required, not used)
4. Click Create

2. Get Test Token

1. Open your app settings
2. Click Create test token
3. Copy the token

3. Configure Shell

# Add to ~/.zshrc.local or ~/.bashrc
export RAINDROP_TOKEN="your_test_token_here"

4. Verify

curl -s "https://api.raindrop.io/rest/v1/user" \
  -H "Authorization: Bearer $RAINDROP_TOKEN" | jq .fullName

Why Test Tokens?

We use Raindrop's test token + environment variable approach because:

• Standard pattern — Same as GH_TOKEN, ANTHROPIC_API_KEY, etc.
• No expiration — Test tokens are permanent (OAuth