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.
- Tools
- 37
- What they doRead · write · destructive
- 17 · 11 · 917 read11 write9 destructive
- Users sign in with
- OAuth
- OAuth app
- Your own Raindrop app
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Raindrop connection
In AgentKit > Connections, create a Raindrop connection and copy its redirect URI. The name you give it is the
connection_nameyour code passes. See Configure connections.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.
Authorize a user and make your first call
quickstart.mts 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.actionsconst connector = 'raindrop'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'raindrop_get_collection_counts',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_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.actionsconnection_name = "raindrop"identifier = "user_123"# Generate an authorization link for the userlink_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 callresult = actions.execute_tool(tool_input={},tool_name="raindrop_get_collection_counts",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolraindrop_check_urls_existCheck whether URLs are already saved as bookmarks.Read-onlyCheck URLs Exist
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.
Inputs
urlsarrayrequired- URLs to look up, as an array of strings including scheme.
raindrop_get_bookmarkRetrieve one bookmark (raindrop) by ID.Read-onlyGet Bookmark
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.
Inputs
bookmark_idintegerrequired- Numeric ID of the bookmark (raindrop). Use the _id returned by raindrop_list_bookmarks or raindrop_create_bookmark.
raindrop_get_collectionRetrieve one collection by ID.Read-onlyGet Collection
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.
Inputs
collection_idintegerrequired- Numeric ID of the collection. Use the ID returned by raindrop_list_collections.
raindrop_get_collection_countsRetrieve bookmark counts for the system collections (All, Unsorted, Trash) plus account-level broken-link and duplicate counts.Read-onlyGet Collection Counts
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.
Inputs
This tool takes no inputs.
raindrop_get_filtersGet filter counts for a collection: bookmarks by type, tags, favorites, untagged, broken and duplicates.Read-onlyGet Filters
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.
Inputs
collection_idintegerrequired- Collection to compute filters for. Use 0 for all collections.
searchstring- Search query to restrict the counted bookmarks, same syntax as raindrop_list_bookmarks.
tags_sortstring- Sort of the tags list: -count (by usage, default) or _id (by name).one of
-count_id
raindrop_get_userRetrieve the profile of the Raindrop user who authorized the connection.Read-onlyGet Authenticated User
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.
Inputs
This tool takes no inputs.
raindrop_list_bookmarksList bookmarks (raindrops) in a collection, with optional search, sorting and paging.Read-onlyList Bookmarks
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.
Inputs
collection_idintegerrequired- 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.
nestedboolean- Set true to also include bookmarks from nested sub-collections.
pageinteger- Zero-based page number. Combine with perpage to page through results.
perpageinteger- Bookmarks per page, maximum 50.
searchstring- Search query using Raindrop search syntax, for example 'javascript #dev' or 'domain:github.com'. Omit to list everything.
sortstring- Sort order: -created (newest first, default), created, score (relevance, only with search), -sort (manual order), title, -title, domain or -domain.one of
-createdcreatedscore-sorttitle-titledomain-domain
raindrop_list_child_collectionsList all nested (child) collections of the authenticated user.Read-onlyList Child Collections
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.
Inputs
This tool takes no inputs.
raindrop_list_collaboratorsList the collaborators of a shared collection.Read-onlyList Collection Collaborators
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.
Inputs
collection_idintegerrequired- Numeric ID of the collection. Use the ID returned by raindrop_list_collections.
raindrop_list_collection_highlightsList highlights from the bookmarks in one collection.Read-onlyList Collection Highlights
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.
Inputs
collection_idintegerrequired- Numeric ID of the collection. Use the ID returned by raindrop_list_collections.
pageinteger- Zero-based page number.
perpageinteger- Highlights per page, maximum 50 (default 25).
raindrop_list_collectionsList the root-level collections of the authenticated user.Read-onlyList Root Collections
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.
Inputs
This tool takes no inputs.
raindrop_list_highlightsList highlights across all bookmarks.Read-onlyList Highlights
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.
Inputs
pageinteger- Zero-based page number.
perpageinteger- Highlights per page, maximum 50 (default 25).
raindrop_parse_urlFetch the title, description, cover media, type and metadata Raindrop would extract for a URL, without saving it.Read-onlyParse URL
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.
Inputs
urlstringrequired- The URL to parse, including scheme.
raindrop_suggest_for_bookmarkGet suggested collections and tags for an existing bookmark.Read-onlySuggest Collection and Tags for Bookmark
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.
Inputs
bookmark_idintegerrequired- Numeric ID of the bookmark (raindrop). Use the _id returned by raindrop_list_bookmarks or raindrop_create_bookmark.
raindrop_suggest_for_urlGet suggested collections and tags for a URL that is not saved yet.Read-onlySuggest Collection and Tags for URL
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.
Inputs
linkstringrequired- The URL to get suggestions for, including scheme.
raindrop_add_highlightAdd a text highlight to a bookmark.WriteAdd Highlight
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.
Inputs
bookmark_idintegerrequired- Numeric ID of the bookmark (raindrop). Use the _id returned by raindrop_list_bookmarks or raindrop_create_bookmark.
textstringrequired- The highlighted text from the page.
colorstring- Highlight color; defaults to yellow. One of blue, brown, cyan, gray, green, indigo, orange, pink, purple, red, teal or yellow.one of
bluebrowncyangraygreenindigoorangepinkpurpleredtealyellow notestring- Optional note to attach to the highlight.
raindrop_create_bookmarkSave a new bookmark (raindrop) from a URL, with optional title, tags, note and collection.WriteCreate Bookmark
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.
Inputs
linkstringrequired- The URL to bookmark, including scheme.
collection_idinteger- 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.
coverstring- URL of an image to use as the bookmark cover.
excerptstring- Short description of the bookmark (max 10000 characters).
importantboolean- Set true to mark the bookmark as a favorite, false to unmark it.
notestring- Personal note attached to the bookmark (max 10000 characters).
ordernumber- Position within the collection in ascending order. Use 0 to move the bookmark to the first place.
please_parseboolean- Set true to have Raindrop fetch the page's cover, description and other metadata in the background.
tagsarray- Tags to apply, as an array of plain tag names (strings).
titlestring- Title of the bookmark (max 1000 characters). Omit to let Raindrop fetch it when please_parse is true.
typestring- Bookmark type: link, article, image, video, document or audio.one of
linkarticleimagevideodocumentaudio
raindrop_create_bookmarksCreate up to 100 bookmarks in one call.WriteCreate Multiple Bookmarks
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.
Inputs
itemsarrayrequired- 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}}].
raindrop_create_collectionCreate a new collection to group bookmarks, optionally nested under a parent collection.WriteCreate Collection
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.
Inputs
titlestringrequired- Name of the new collection, for example 'Reading list'.
coverstring- URL of an image to use as the collection cover. Omit to keep the default cover.
parent_idinteger- ID of the parent collection to nest this one under. Omit to create a root collection.
publicboolean- Set true to make the collection and its bookmarks readable by anyone with the public link. Omit to keep it private.
sortnumber- Position among sibling collections, in descending order. Omit to use the default position.
viewstring- How the collection displays bookmarks. One of list (default), simple, grid or masonry.one of
listsimplegridmasonry
raindrop_rename_tagRename a tag across all bookmarks.WriteRename Tag
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.
- Idempotent
Inputs
new_namestringrequired- New name for the tag.
tagstringrequired- Current name of the tag to rename.
raindrop_update_bookmarkUpdate fields of an existing bookmark: title, description, note, tags, collection, favorite flag, cover or link.WriteUpdate Bookmark
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.
- Idempotent
Inputs
bookmark_idintegerrequired- Numeric ID of the bookmark (raindrop). Use the _id returned by raindrop_list_bookmarks or raindrop_create_bookmark.
collection_idinteger- 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.
coverstring- URL of an image to use as the bookmark cover.
excerptstring- Short description of the bookmark (max 10000 characters).
importantboolean- Set true to mark the bookmark as a favorite, false to unmark it.
linkstring- The URL to bookmark, including scheme.
notestring- Personal note attached to the bookmark (max 10000 characters).
ordernumber- Position within the collection in ascending order. Use 0 to move the bookmark to the first place.
please_parseboolean- Set true to have Raindrop fetch the page's cover, description and other metadata in the background.
tagsarray- Tags to apply, as an array of plain tag names (strings).
titlestring- Title of the bookmark (max 1000 characters). Omit to let Raindrop fetch it when please_parse is true.
typestring- Bookmark type: link, article, image, video, document or audio.one of
linkarticleimagevideodocumentaudio
raindrop_update_bookmarksBulk-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.WriteUpdate Multiple Bookmarks
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.
Inputs
collection_idintegerrequired- Collection whose bookmarks to update. Use 0 for all bookmarks, -1 for Unsorted, or a collection ID.
coverstring- Cover image URL to set on every matched bookmark. Use <screenshot> to use page screenshots.
idsarray- IDs of the bookmarks to update, as an array of integers. Omit to rely on search or to update the whole collection.
importantboolean- Set true to mark the bookmarks as favorites, false to unmark them.
move_to_collection_idinteger- ID of the collection to move the matched bookmarks into. Use -99 to move them to Trash.
nestedboolean- Set true to include bookmarks from nested sub-collections.
searchstring- Search query restricting which bookmarks are updated, same syntax as raindrop_list_bookmarks.
tagsarray- Tags to append to every matched bookmark, as an array of strings. Pass an empty array to remove all tags from them.
raindrop_update_collaborator_roleChange the access level of a collaborator on a shared collection.WriteUpdate Collaborator Role
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.
- Idempotent
Inputs
collection_idintegerrequired- Numeric ID of the collection. Use the ID returned by raindrop_list_collections.
rolestringrequired- New access level: member (write access) or viewer (read-only).one of
memberviewer user_idintegerrequired- Numeric user ID of the collaborator, from raindrop_list_collaborators.
raindrop_update_collectionUpdate a collection's title, view, visibility, parent, order, expanded state or cover.WriteUpdate Collection
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.
- Idempotent
Inputs
collection_idintegerrequired- Numeric ID of the collection. Use the ID returned by raindrop_list_collections.
coverstring- URL of an image to use as the new collection cover.
expandedboolean- Set true to expand the collection's sub-collections in the sidebar, false to collapse them.
parent_idinteger- ID of the collection to move this one under. Cannot be used to move a collection back to the root.
publicboolean- Set true to share the collection by public link, false to make it private.
sortnumber- New position among sibling collections, in descending order.
titlestring- New name for the collection.
viewstring- New display style. One of list, simple, grid or masonry.one of
listsimplegridmasonry
raindrop_update_highlightChange the note or color of an existing highlight on a bookmark.WriteUpdate Highlight
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.
- Idempotent
Inputs
bookmark_idintegerrequired- Numeric ID of the bookmark (raindrop). Use the _id returned by raindrop_list_bookmarks or raindrop_create_bookmark.
highlight_idstringrequired- The _id of the highlight to update, from the bookmark's highlights array.
colorstring- New color. One of blue, brown, cyan, gray, green, indigo, orange, pink, purple, red, teal or yellow.one of
bluebrowncyangraygreenindigoorangepinkpurpleredtealyellow notestring- New note for the highlight.
raindrop_delete_bookmarkDelete a bookmark.DestructiveDelete Bookmark
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.
- Idempotent
Inputs
bookmark_idintegerrequired- Numeric ID of the bookmark (raindrop). Use the _id returned by raindrop_list_bookmarks or raindrop_create_bookmark.
raindrop_delete_bookmarksMove specific bookmarks in a collection to Trash.DestructiveDelete Multiple Bookmarks
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.
- Idempotent
Inputs
collection_idintegerrequired- Collection the bookmarks are in. Use 0 for all bookmarks, -1 for Unsorted, -99 for Trash (permanent deletion), or a collection ID.
idsarrayrequired- IDs of the bookmarks to delete, as an array of integers.
raindrop_delete_collectionDelete a collection and all of its nested collections.DestructiveDelete Collection
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.
- Idempotent
Inputs
collection_idintegerrequired- Numeric ID of the collection to delete. Use the ID returned by raindrop_list_collections.
raindrop_delete_collectionsDelete several collections in one call.DestructiveDelete Multiple Collections
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.
- Idempotent
Inputs
idsarrayrequired- IDs of the collections to delete, as an array of integers.
raindrop_merge_collectionsMerge one or more collections into a destination collection.DestructiveMerge Collections
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.
- Idempotent
Inputs
idsarrayrequired- IDs of the source collections to merge into the destination, as an array of integers.
tointegerrequired- ID of the destination collection that will receive the merged collections.
raindrop_remove_collaboratorRemove a collaborator from a shared collection.DestructiveRemove Collaborator
Remove a collaborator from a shared collection. Returns {result: true} on success. Use raindrop_list_collaborators to find collaborator user IDs.
- Idempotent
Inputs
collection_idintegerrequired- Numeric ID of the collection. Use the ID returned by raindrop_list_collections.
user_idintegerrequired- Numeric user ID of the collaborator to remove, from raindrop_list_collaborators.
raindrop_remove_highlightRemove a highlight from a bookmark.DestructiveRemove Highlight
Remove a highlight from a bookmark. Returns the updated bookmark with the remaining highlights. Use raindrop_get_bookmark to find the highlight _id.
- Idempotent
Inputs
bookmark_idintegerrequired- Numeric ID of the bookmark (raindrop). Use the _id returned by raindrop_list_bookmarks or raindrop_create_bookmark.
highlight_idstringrequired- The _id of the highlight to remove, from the bookmark's highlights array.
No tools match.