Raindrop Api

This is a comprehensive implementation for working with Raindrop.io bookmarks through their REST API using curl and jq. It covers everything from authentication and token management to full CRUD operations on bookmarks, collections, tags, and highlights. The skill includes built-in safety confirmations for destructive actions, handles pagination and search operators, and provides concrete curl examples for every endpoint. If you're building workflows that need to read, organize, or bulk-update bookmarks programmatically, this gives you the complete API surface without having to dig through the official docs yourself.

skills.sh installs: 507
GitHub stars: 301
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add intellectronica/agent-skills --skill raindrop-api --agent claude-code

Installs into .claude/skills of the current project.

Files

Raindrop.io API Skill

This skill enables interaction with the Raindrop.io bookmarks service through its REST API. Use curl and jq for direct REST calls.

Official API documentation: https://developer.raindrop.io/

Authentication

Token Resolution

Resolve the API token in this order:

Check environment variable RAINDROP_TOKEN
Check if the user has provided a token in the conversation context
If neither is available, use AskUserQuestion to request the token from the user

To verify a token exists in the environment:

[ -n "$RAINDROP_TOKEN" ] && echo "Token available" || echo "Token not set"

Quick setup: For personal use or development, generate a test token at https://app.raindrop.io/settings/integrations — open your app and copy the "Test token". Test tokens do not expire.

For full OAuth2 flow details, see the Authentication section below.

Making Authenticated Requests

All requests require the Authorization header with Bearer token:

curl -s -H "Authorization: Bearer $RAINDROP_TOKEN" \
  "https://api.raindrop.io/rest/v1/ENDPOINT"

For POST/PUT requests with JSON body:

SKILL.md on GitHub

Details

Repository: github.com/intellectronica/agent-skills
Categories: Backend & APIs, Security, AI & Agent Building
License: CC0-1.0
First seen: Jun 3, 2026