> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Raindrop

The Raindrop connector lets your AI agent act in each user's Raindrop account. Each user signs in to Raindrop once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 37 tools.

**Authentication:** OAuth 2.0
**Categories:** Productivity
**Tools:** 37: 17 read, 11 write, 9 destructive
**Users sign in with:** OAuth
**OAuth app:** Your own Raindrop app
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=RAINDROP)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Raindrop connection

   In **AgentKit > Connections**, create a Raindrop connection and copy its redirect URI. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Register an OAuth app

   Raindrop connections use your own OAuth app. Register one with Raindrop and add the redirect URI you copied.

   Then enter the app's Client ID and Client Secret on the Raindrop connection.

5. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'raindrop'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Raindrop:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'raindrop_get_collection_counts',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "raindrop"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Raindrop:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="raindrop_get_collection_counts",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user signs in once. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'raindrop_check_urls_exist',
  toolInput: {
    urls: [],
  },
  connector: 'raindrop',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="raindrop_check_urls_exist",
    tool_input={
        "urls": [],
    },
    connection_name="raindrop",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `raindrop_check_urls_exist`

Check URLs Exist · Read-only

Check whether URLs are already saved as bookmarks.
Returns result true and an ids array holding the IDs of the matching existing bookmarks; the array is empty or the result is false when none match.
Use before raindrop_create_bookmark or raindrop_create_bookmarks to avoid duplicates. Does not change anything.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `urls` (`array`, required): URLs to look up, as an array of strings including scheme.

Example input: `{"urls":[]}`

### `raindrop_get_bookmark`

Get Bookmark · Read-only

Retrieve one bookmark (raindrop) by ID.
Returns the bookmark's _id, title, link, excerpt, note, tags, type, cover, collection, highlights, important flag and timestamps.
Use raindrop_list_bookmarks to find bookmark IDs or to search.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bookmark_id` (`integer`, required): Numeric ID of the bookmark (raindrop). Use the _id returned by raindrop_list_bookmarks or raindrop_create_bookmark.

Example input: `{"bookmark_id":1}`

### `raindrop_get_collection`

Get Collection · Read-only

Retrieve one collection by ID.
Returns the collection's _id, title, count, color, cover, view, public flag, access level, sharing info, parent and timestamps.
Use raindrop_list_collections to discover collection IDs first.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collection_id` (`integer`, required): Numeric ID of the collection. Use the ID returned by raindrop_list_collections.

Example input: `{"collection_id":1}`

### `raindrop_get_collection_counts`

Get Collection Counts · Read-only

Retrieve bookmark counts for the system collections (All, Unsorted, Trash) plus account-level broken-link and duplicate counts.
Returns an items array of {_id, count} for collection IDs 0 (all), -1 (Unsorted) and -99 (Trash), and a meta object with PRO status and the broken and duplicate counts.
Use raindrop_list_collections for user-created collections. Use raindrop_get_filters for counts inside one collection.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `raindrop_get_filters`

Get Filters · Read-only

Get filter counts for a collection: bookmarks by type, tags, favorites, untagged, broken and duplicates.
Returns broken, duplicates, important and notag counts plus tags and types arrays of {_id, count}.
Use raindrop_list_bookmarks with a search query to fetch the matching bookmarks.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collection_id` (`integer`, required): Collection to compute filters for. Use 0 for all collections.
- `search` (`string`, optional): Search query to restrict the counted bookmarks, same syntax as raindrop_list_bookmarks.
- `tags_sort` (`string`, optional): Sort of the tags list: -count (by usage, default) or _id (by name). One of: `-count`, `_id`.

Example input: `{"collection_id":1}`

### `raindrop_get_user`

Get Authenticated User · Read-only

Retrieve the profile of the Raindrop user who authorized the connection.
Returns the user ID, full name, email, PRO status and expiry, file storage usage, collection groups and preferences.
Use this to confirm which account is connected. Use raindrop_get_collection_counts for bookmark totals.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `raindrop_list_bookmarks`

List Bookmarks · Read-only

List bookmarks (raindrops) in a collection, with optional search, sorting and paging.
Returns an items array of bookmarks (_id, title, link, excerpt, note, tags, type, collection, created) and the total count.
Use raindrop_get_bookmark for one bookmark by ID. Pass collection_id 0 for all bookmarks, -1 for Unsorted or -99 for Trash.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collection_id` (`integer`, required): Collection to read from. Use 0 for all bookmarks except Trash, -1 for Unsorted, -99 for Trash, or a collection ID from raindrop_list_collections.
- `nested` (`boolean`, optional): Set true to also include bookmarks from nested sub-collections.
- `page` (`integer`, optional): Zero-based page number. Combine with perpage to page through results.
- `perpage` (`integer`, optional): Bookmarks per page, maximum 50.
- `search` (`string`, optional): Search query using Raindrop search syntax, for example 'javascript #dev' or 'domain:github.com'. Omit to list everything.
- `sort` (`string`, optional): Sort order: -created (newest first, default), created, score (relevance, only with search), -sort (manual order), title, -title, domain or -domain. One of: `-created`, `created`, `score`, `-sort`, `title`, `-title`, `domain`, `-domain`.

Example input: `{"collection_id":1}`

### `raindrop_list_child_collections`

List Child Collections · Read-only

List all nested (child) collections of the authenticated user.
Returns the same fields as raindrop_list_collections plus parent.$id for each collection, which links it to its parent.
Use raindrop_list_collections for root collections. Combine both lists to rebuild the full collection tree.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `raindrop_list_collaborators`

List Collection Collaborators · Read-only

List the collaborators of a shared collection.
Returns each collaborator's _id, full name, email (only when you own the collection), email_MD5 and role (member or viewer).
Use raindrop_share_collection to invite people.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collection_id` (`integer`, required): Numeric ID of the collection. Use the ID returned by raindrop_list_collections.

Example input: `{"collection_id":1}`

### `raindrop_list_collection_highlights`

List Collection Highlights · Read-only

List highlights from the bookmarks in one collection.
Returns an items array of highlights (_id, text, color, note, created, plus the parent bookmark's title, link and tags).
Use raindrop_list_highlights for all collections.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collection_id` (`integer`, required): Numeric ID of the collection. Use the ID returned by raindrop_list_collections.
- `page` (`integer`, optional): Zero-based page number.
- `perpage` (`integer`, optional): Highlights per page, maximum 50 (default 25).

Example input: `{"collection_id":1}`

### `raindrop_list_collection_tags`

List Collection Tags · Read-only

List the tags used in one collection.
Returns an items array of {_id: tag name, count: number of bookmarks}.
Use raindrop_list_tags for tags across all collections.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collection_id` (`integer`, required): Numeric ID of the collection. Use the ID returned by raindrop_list_collections.

Example input: `{"collection_id":1}`

### `raindrop_list_collections`

List Root Collections · Read-only

List the root-level collections of the authenticated user.
Returns each collection's _id, title, count, color, cover, view, sharing flags, parent and timestamps. Nested collections are not included.
Use raindrop_list_child_collections for nested collections. System collections (Unsorted -1, Trash -99) are not returned here.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `raindrop_list_highlights`

List Highlights · Read-only

List highlights across all bookmarks.
Returns an items array of highlights (_id, text, color, note, created, plus the parent bookmark's title, link and tags).
Use raindrop_list_collection_highlights to limit to one collection.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page` (`integer`, optional): Zero-based page number.
- `perpage` (`integer`, optional): Highlights per page, maximum 50 (default 25).

Example input: `{}`

### `raindrop_list_tags`

List Tags · Read-only

List all tags used across all collections.
Returns an items array of {_id: tag name, count: number of bookmarks}.
Use raindrop_list_collection_tags to limit to one collection.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `raindrop_parse_url`

Parse URL · Read-only

Fetch the title, description, cover media, type and metadata Raindrop would extract for a URL, without saving it.
Returns an item with title, excerpt, media, type and meta (canonical URL, site name, tags).
Use raindrop_create_bookmark to save the URL. Does not create anything.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `url` (`string`, required): The URL to parse, including scheme.

Example input: `{"url":"<url>"}`

### `raindrop_suggest_for_bookmark`

Suggest Collection and Tags for Bookmark · Read-only

Get suggested collections and tags for an existing bookmark.
Returns an item with a collections array of {$id} and a tags array of strings.
Use raindrop_suggest_for_url for a URL that is not saved yet.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bookmark_id` (`integer`, required): Numeric ID of the bookmark (raindrop). Use the _id returned by raindrop_list_bookmarks or raindrop_create_bookmark.

Example input: `{"bookmark_id":1}`

### `raindrop_suggest_for_url`

Suggest Collection and Tags for URL · Read-only

Get suggested collections and tags for a URL that is not saved yet.
Returns an item with a collections array of {$id} and a tags array of strings.
Use raindrop_suggest_for_bookmark for a bookmark that already exists. Does not create or change anything.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `link` (`string`, required): The URL to get suggestions for, including scheme.

Example input: `{"link":"<link>"}`

### `raindrop_add_highlight`

Add Highlight · Write

Add a text highlight to a bookmark.
Returns the updated bookmark including its highlights array with each highlight's _id.
Use raindrop_update_highlight to edit one later and raindrop_remove_highlight to delete it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `bookmark_id` (`integer`, required): Numeric ID of the bookmark (raindrop). Use the _id returned by raindrop_list_bookmarks or raindrop_create_bookmark.
- `text` (`string`, required): The highlighted text from the page.
- `color` (`string`, optional): Highlight color; defaults to yellow. One of blue, brown, cyan, gray, green, indigo, orange, pink, purple, red, teal or yellow. One of: `blue`, `brown`, `cyan`, `gray`, `green`, `indigo`, `orange`, `pink`, `purple`, `red`, `teal`, `yellow`.
- `note` (`string`, optional): Optional note to attach to the highlight.

Example input: `{"bookmark_id":1,"text":"<text>"}`

### `raindrop_create_bookmark`

Create Bookmark · Write

Save a new bookmark (raindrop) from a URL, with optional title, tags, note and collection.
Returns the created bookmark with its _id, link, title, tags, collection and timestamps.
Use raindrop_create_bookmarks to save many at once and raindrop_check_urls_exist to avoid duplicates. Set please_parse to true to auto-fill title, description and cover.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `link` (`string`, required): The URL to bookmark, including scheme.
- `collection_id` (`integer`, optional): ID of the collection to store the bookmark in. Use -1 for Unsorted. Omit to use the default (Unsorted) for new bookmarks or to keep the current collection on update.
- `cover` (`string`, optional): URL of an image to use as the bookmark cover.
- `excerpt` (`string`, optional): Short description of the bookmark (max 10000 characters).
- `important` (`boolean`, optional): Set true to mark the bookmark as a favorite, false to unmark it.
- `note` (`string`, optional): Personal note attached to the bookmark (max 10000 characters).
- `order` (`number`, optional): Position within the collection in ascending order. Use 0 to move the bookmark to the first place.
- `please_parse` (`boolean`, optional): Set true to have Raindrop fetch the page's cover, description and other metadata in the background.
- `tags` (`array`, optional): Tags to apply, as an array of plain tag names (strings).
- `title` (`string`, optional): Title of the bookmark (max 1000 characters). Omit to let Raindrop fetch it when please_parse is true.
- `type` (`string`, optional): Bookmark type: link, article, image, video, document or audio. One of: `link`, `article`, `image`, `video`, `document`, `audio`.

Example input: `{"link":"<link>"}`

### `raindrop_create_bookmarks`

Create Multiple Bookmarks · Write

Create up to 100 bookmarks in one call.
Returns an items array with each created bookmark and its _id.
Use raindrop_create_bookmark for a single bookmark. Each entry needs a link; title, excerpt, note, tags and a collection object like {"$id": 8492393} are optional.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `items` (`array`, required): Bookmarks to create, maximum 100. Each entry is an object with a required link and optional title, excerpt, note, tags (array of strings), important, and collection as an object holding the collection ID under $id. Example: [{"link": "https://example.com", "title": "Example", "tags": ["demo"], "collection": {"$id": 8492393}}].

Example input: `{"items":[]}`

### `raindrop_create_collection`

Create Collection · Write

Create a new collection to group bookmarks, optionally nested under a parent collection.
Returns the created collection with its _id, title, view, public flag, parent and timestamps.
Use raindrop_update_collection to change an existing collection. Pass parent_id to nest it; omit parent_id to create a root collection.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `title` (`string`, required): Name of the new collection, for example 'Reading list'.
- `cover` (`string`, optional): URL of an image to use as the collection cover. Omit to keep the default cover.
- `parent_id` (`integer`, optional): ID of the parent collection to nest this one under. Omit to create a root collection.
- `public` (`boolean`, optional): Set true to make the collection and its bookmarks readable by anyone with the public link. Omit to keep it private.
- `sort` (`number`, optional): Position among sibling collections, in descending order. Omit to use the default position.
- `view` (`string`, optional): How the collection displays bookmarks. One of list (default), simple, grid or masonry. One of: `list`, `simple`, `grid`, `masonry`.

Example input: `{"title":"<title>"}`

### `raindrop_rename_tag`

Rename Tag · Write

Rename a tag across all bookmarks.
Returns {result: true} on success.
Use raindrop_merge_tags to combine several tags into one and raindrop_delete_tags to remove tags.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `new_name` (`string`, required): New name for the tag.
- `tag` (`string`, required): Current name of the tag to rename.

Example input: `{"new_name":"<new_name>","tag":"<tag>"}`

### `raindrop_share_collection`

Share Collection · Write

Invite people to a collection by email. Each address receives an invitation link.
Returns {result: true} on success.
Use raindrop_update_collaborator_role to change access later and raindrop_remove_collaborator to revoke it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `collection_id` (`integer`, required): Numeric ID of the collection to share. Use the ID returned by raindrop_list_collections.
- `emails` (`array`, required): Email addresses to invite, as an array of strings. Maximum 10 per call.
- `role` (`string`, required): Access level for the invitees. member can add and edit bookmarks and invite others; viewer is read-only. One of: `member`, `viewer`.

Example input: `{"collection_id":1,"emails":[],"role":"member"}`

### `raindrop_update_bookmark`

Update Bookmark · Write

Update fields of an existing bookmark: title, description, note, tags, collection, favorite flag, cover or link. Only the fields you pass change.
Returns the updated bookmark.
Use raindrop_update_bookmarks to change many at once and raindrop_delete_bookmark to remove one. Passing tags replaces the bookmark's tags.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bookmark_id` (`integer`, required): Numeric ID of the bookmark (raindrop). Use the _id returned by raindrop_list_bookmarks or raindrop_create_bookmark.
- `collection_id` (`integer`, optional): ID of the collection to store the bookmark in. Use -1 for Unsorted. Omit to use the default (Unsorted) for new bookmarks or to keep the current collection on update.
- `cover` (`string`, optional): URL of an image to use as the bookmark cover.
- `excerpt` (`string`, optional): Short description of the bookmark (max 10000 characters).
- `important` (`boolean`, optional): Set true to mark the bookmark as a favorite, false to unmark it.
- `link` (`string`, optional): The URL to bookmark, including scheme.
- `note` (`string`, optional): Personal note attached to the bookmark (max 10000 characters).
- `order` (`number`, optional): Position within the collection in ascending order. Use 0 to move the bookmark to the first place.
- `please_parse` (`boolean`, optional): Set true to have Raindrop fetch the page's cover, description and other metadata in the background.
- `tags` (`array`, optional): Tags to apply, as an array of plain tag names (strings).
- `title` (`string`, optional): Title of the bookmark (max 1000 characters). Omit to let Raindrop fetch it when please_parse is true.
- `type` (`string`, optional): Bookmark type: link, article, image, video, document or audio. One of: `link`, `article`, `image`, `video`, `document`, `audio`.

Example input: `{"bookmark_id":1}`

### `raindrop_update_bookmarks`

Update Multiple Bookmarks · Write

Bulk-update bookmarks in a collection, limited to specific IDs and/or a search query: add tags, set favorite, set cover or move to another collection.
Returns {result: true} and the number of modified bookmarks.
Without ids or search, every bookmark in the collection is changed, so pass ids or search to narrow it. Tags passed here are appended; an empty array removes all tags.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `collection_id` (`integer`, required): Collection whose bookmarks to update. Use 0 for all bookmarks, -1 for Unsorted, or a collection ID.
- `cover` (`string`, optional): Cover image URL to set on every matched bookmark. Use <screenshot> to use page screenshots.
- `ids` (`array`, optional): IDs of the bookmarks to update, as an array of integers. Omit to rely on search or to update the whole collection.
- `important` (`boolean`, optional): Set true to mark the bookmarks as favorites, false to unmark them.
- `move_to_collection_id` (`integer`, optional): ID of the collection to move the matched bookmarks into. Use -99 to move them to Trash.
- `nested` (`boolean`, optional): Set true to include bookmarks from nested sub-collections.
- `search` (`string`, optional): Search query restricting which bookmarks are updated, same syntax as raindrop_list_bookmarks.
- `tags` (`array`, optional): Tags to append to every matched bookmark, as an array of strings. Pass an empty array to remove all tags from them.

Example input: `{"collection_id":1}`

### `raindrop_update_collaborator_role`

Update Collaborator Role · Write

Change the access level of a collaborator on a shared collection.
Returns {result: true} on success.
Use raindrop_list_collaborators to find collaborator user IDs.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collection_id` (`integer`, required): Numeric ID of the collection. Use the ID returned by raindrop_list_collections.
- `role` (`string`, required): New access level: member (write access) or viewer (read-only). One of: `member`, `viewer`.
- `user_id` (`integer`, required): Numeric user ID of the collaborator, from raindrop_list_collaborators.

Example input: `{"collection_id":1,"role":"member","user_id":1}`

### `raindrop_update_collection`

Update Collection · Write

Update a collection's title, view, visibility, parent, order, expanded state or cover. Only the fields you pass change.
Returns the updated collection.
Use raindrop_create_collection to make a new one. Use raindrop_merge_collections to combine collections.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collection_id` (`integer`, required): Numeric ID of the collection. Use the ID returned by raindrop_list_collections.
- `cover` (`string`, optional): URL of an image to use as the new collection cover.
- `expanded` (`boolean`, optional): Set true to expand the collection's sub-collections in the sidebar, false to collapse them.
- `parent_id` (`integer`, optional): ID of the collection to move this one under. Cannot be used to move a collection back to the root.
- `public` (`boolean`, optional): Set true to share the collection by public link, false to make it private.
- `sort` (`number`, optional): New position among sibling collections, in descending order.
- `title` (`string`, optional): New name for the collection.
- `view` (`string`, optional): New display style. One of list, simple, grid or masonry. One of: `list`, `simple`, `grid`, `masonry`.

Example input: `{"collection_id":1}`

### `raindrop_update_highlight`

Update Highlight · Write

Change the note or color of an existing highlight on a bookmark.
Returns the updated bookmark including its highlights array.
Use raindrop_get_bookmark to find the highlight _id. The highlight text itself cannot be changed here.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bookmark_id` (`integer`, required): Numeric ID of the bookmark (raindrop). Use the _id returned by raindrop_list_bookmarks or raindrop_create_bookmark.
- `highlight_id` (`string`, required): The _id of the highlight to update, from the bookmark's highlights array.
- `color` (`string`, optional): New color. One of blue, brown, cyan, gray, green, indigo, orange, pink, purple, red, teal or yellow. One of: `blue`, `brown`, `cyan`, `gray`, `green`, `indigo`, `orange`, `pink`, `purple`, `red`, `teal`, `yellow`.
- `note` (`string`, optional): New note for the highlight.

Example input: `{"bookmark_id":1,"highlight_id":"<highlight_id>"}`

### `raindrop_delete_bookmark`

Delete Bookmark · Destructive

Delete a bookmark. It moves to Trash; deleting a bookmark already in Trash removes it permanently.
Returns {result: true} on success.
Use raindrop_delete_bookmarks to delete many at once.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `bookmark_id` (`integer`, required): Numeric ID of the bookmark (raindrop). Use the _id returned by raindrop_list_bookmarks or raindrop_create_bookmark.

Example input: `{"bookmark_id":1}`

### `raindrop_delete_bookmarks`

Delete Multiple Bookmarks · Destructive

Move specific bookmarks in a collection to Trash. In the Trash collection (-99) they are deleted permanently.
Returns {result: true} and the number of modified bookmarks.
Use raindrop_delete_bookmark for one bookmark. Bookmark IDs are required so a call can never clear a whole collection by accident.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `collection_id` (`integer`, required): Collection the bookmarks are in. Use 0 for all bookmarks, -1 for Unsorted, -99 for Trash (permanent deletion), or a collection ID.
- `ids` (`array`, required): IDs of the bookmarks to delete, as an array of integers.

Example input: `{"collection_id":1,"ids":[]}`

### `raindrop_delete_collection`

Delete Collection · Destructive

Delete a collection and all of its nested collections. Its bookmarks are moved to Trash.
Returns {result: true} on success.
Use raindrop_delete_collections to remove several collections at once. Deleting collection -99 empties the Trash permanently.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `collection_id` (`integer`, required): Numeric ID of the collection to delete. Use the ID returned by raindrop_list_collections.

Example input: `{"collection_id":1}`

### `raindrop_delete_collections`

Delete Multiple Collections · Destructive

Delete several collections in one call. Nested collections are ignored unless their IDs are also listed. Bookmarks move to Trash.
Returns {result: true} on success.
Use raindrop_delete_collection for a single collection.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `ids` (`array`, required): IDs of the collections to delete, as an array of integers.

Example input: `{"ids":[]}`

### `raindrop_delete_tags`

Delete Tags · Destructive

Remove tags from all bookmarks. The bookmarks themselves are kept.
Returns {result: true} on success.
Use raindrop_rename_tag or raindrop_merge_tags to keep the tag under another name.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `tags` (`array`, required): Names of the tags to delete, as an array of strings.

Example input: `{"tags":[]}`

### `raindrop_merge_collections`

Merge Collections · Destructive

Merge one or more collections into a destination collection. Bookmarks from the source collections move to the destination.
Returns {result: true} on success.
Use raindrop_delete_collections instead if you want to discard collections rather than merge them.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `ids` (`array`, required): IDs of the source collections to merge into the destination, as an array of integers.
- `to` (`integer`, required): ID of the destination collection that will receive the merged collections.

Example input: `{"ids":[],"to":1}`

### `raindrop_merge_tags`

Merge Tags · Destructive

Merge several tags into one new or existing tag across all bookmarks.
Returns {result: true} on success.
Use raindrop_rename_tag for a single tag.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `new_name` (`string`, required): Name of the tag that replaces all listed tags.
- `tags` (`array`, required): Names of the tags to merge, as an array of strings.

Example input: `{"new_name":"<new_name>","tags":[]}`

### `raindrop_remove_collaborator`

Remove Collaborator · Destructive

Remove a collaborator from a shared collection.
Returns {result: true} on success.
Use raindrop_list_collaborators to find collaborator user IDs.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `collection_id` (`integer`, required): Numeric ID of the collection. Use the ID returned by raindrop_list_collections.
- `user_id` (`integer`, required): Numeric user ID of the collaborator to remove, from raindrop_list_collaborators.

Example input: `{"collection_id":1,"user_id":1}`

### `raindrop_remove_highlight`

Remove Highlight · Destructive

Remove a highlight from a bookmark.
Returns the updated bookmark with the remaining highlights.
Use raindrop_get_bookmark to find the highlight _id.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `bookmark_id` (`integer`, required): Numeric ID of the bookmark (raindrop). Use the _id returned by raindrop_list_bookmarks or raindrop_create_bookmark.
- `highlight_id` (`string`, required): The _id of the highlight to remove, from the bookmark's highlights array.

Example input: `{"bookmark_id":1,"highlight_id":"<highlight_id>"}`

## Related

Other Productivity connectors ([all 203](/agentkit/connectors/?category=productivity)):

- [Slack](/agentkit/connectors/slack/): Scalekit connector, OAuth, 96 tools
- [Notion](/agentkit/connectors/notion/): Scalekit connector, OAuth, 51 tools
- [Google Workspace (DWD)](/agentkit/connectors/googledwd/): Scalekit connector, Service account, 100 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
