# Raindrop

> Manage Raindrop.io bookmarks, collections, tags, and highlights via API. Use when user mentions raindrop, bookmarks, saving links, organizing URLs, bookmark collections, or web highlights.

- **Type:** Skill
- **Install:** `agentstack add skill-gmickel-raindrop-skill-raindrop-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [gmickel](https://agentstack.voostack.com/s/gmickel)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [gmickel](https://github.com/gmickel)
- **Source:** https://github.com/gmickel/raindrop-skill

## Install

```sh
agentstack add skill-gmickel-raindrop-skill-raindrop-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Raindrop.io API Skill

Manage bookmarks via Raindrop.io REST API.

## Prerequisites

User must have `RAINDROP_TOKEN` env var set. If not configured, instruct them to:
1. Create app at https://app.raindrop.io/settings/integrations
2. Generate test token
3. Add `export RAINDROP_TOKEN="..."` to `~/.zshrc.local`

## Authentication

All requests require:
```
Authorization: Bearer $RAINDROP_TOKEN
```

## Base URL

```
https://api.raindrop.io/rest/v1/
```

## Helper Script

Use `scripts/raindrop.sh` for API calls:
```bash
./scripts/raindrop.sh GET /collections
./scripts/raindrop.sh POST /raindrop '{"link":"https://example.com","pleaseParse":{}}'
./scripts/raindrop.sh PUT /raindrop/123 '{"tags":["new-tag"]}'
./scripts/raindrop.sh DELETE /raindrop/123
```

## Quick Reference

### Collections

| Action | Method | Endpoint |
|--------|--------|----------|
| List root | GET | `/collections` |
| List children | GET | `/collections/childrens` |
| Get one | GET | `/collection/{id}` |
| Create | POST | `/collection` |
| Update | PUT | `/collection/{id}` |
| Delete | DELETE | `/collection/{id}` |

### Raindrops (Bookmarks)

| Action | Method | Endpoint |
|--------|--------|----------|
| List | GET | `/raindrops/{collectionId}` |
| Get one | GET | `/raindrop/{id}` |
| Create | POST | `/raindrop` |
| Update | PUT | `/raindrop/{id}` |
| Delete | DELETE | `/raindrop/{id}` |
| Search | GET | `/raindrops/0?search=...` |

Special collection IDs: `0` = all, `-1` = unsorted, `-99` = trash

### Tags

| Action | Method | Endpoint |
|--------|--------|----------|
| List all | GET | `/tags` |
| List in collection | GET | `/tags/{collectionId}` |
| Rename | PUT | `/tags/{collectionId}` |
| Delete | DELETE | `/tags/{collectionId}` |

### Highlights

| Action | Method | Endpoint |
|--------|--------|----------|
| List all | GET | `/highlights` |
| In collection | GET | `/highlights/{collectionId}` |
| Add/Update/Remove | PUT | `/raindrop/{id}` |

Colors: blue, brown, cyan, gray, green, indigo, orange, pink, purple, red, teal, yellow

## Common Operations

### Create bookmark with auto-parse

```bash
./scripts/raindrop.sh POST /raindrop '{
  "link": "https://example.com",
  "collection": {"$id": 12345},
  "tags": ["tag1", "tag2"],
  "pleaseParse": {}
}'
```

### Search bookmarks

```bash
./scripts/raindrop.sh GET '/raindrops/0?search=keyword&sort=-created'
```

Search operators:
- `#tag` - by tag
- `type:article` - by type (link, article, image, video, document, audio)
- `domain:example.com` - by domain
- `created:>2024-01-01` - by date
- `important:true` - favorites only

### Create collection

```bash
./scripts/raindrop.sh POST /collection '{
  "title": "My Collection",
  "public": false
}'
```

### Add highlight to bookmark

```bash
./scripts/raindrop.sh PUT /raindrop/123 '{
  "highlights": [{"text": "highlighted text", "color": "yellow", "note": "my note"}]
}'
```

### Bulk tag bookmarks

```bash
./scripts/raindrop.sh PUT /raindrops/0 '{
  "ids": [1, 2, 3],
  "tags": ["new-tag"]
}'
```

### Export collection

```bash
curl -s "https://api.raindrop.io/rest/v1/raindrops/{collectionId}/export.csv" \
  -H "Authorization: Bearer $RAINDROP_TOKEN" > bookmarks.csv
```

Formats: csv, html, zip

## Rate Limits

120 requests/minute. Check headers: `X-RateLimit-Limit`, `RateLimit-Remaining`, `X-RateLimit-Reset`

## Detailed Reference

See [references/API-REFERENCE.md](references/API-REFERENCE.md) for complete endpoint documentation.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [gmickel](https://github.com/gmickel)
- **Source:** [gmickel/raindrop-skill](https://github.com/gmickel/raindrop-skill)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-gmickel-raindrop-skill-raindrop-skill
- Seller: https://agentstack.voostack.com/s/gmickel
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.