Can I use Raindrop.io as a CLI?

Yes. KosmoKrator exposes a Raindrop.io CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Raindrop.io through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Raindrop.io tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Raindrop.io credentials stored?

Raindrop.io credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Raindrop.io MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

bookmarks

Raindrop.io CLI for AI Agents

Use the Raindrop.io CLI from KosmoKrator to call Raindrop.io tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

7 functions 5 read 2 write Bearer token auth

Submit Raindrop.io feedback View package source

Raindrop.io CLI Setup

Raindrop.io can be configured headlessly with `kosmokrator integrations:configure raindrop`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure raindrop --set access_token="$RAINDROP_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor raindrop --json
kosmokrator integrations:status --json

Credentials

Authentication type: Bearer token bearer_token. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

Key	Env var	Type	Required	Label
`access_token`	`RAINDROP_ACCESS_TOKEN`	Secret `secret`	yes	Access Token
`url`	`RAINDROP_URL`	URL `url`	no	API Base URL

Call Raindrop.io Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call raindrop.raindrop_list_bookmarks '{
  "collection_id": 1,
  "search": "example_search",
  "page": 1,
  "per_page": 1
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:raindrop raindrop_list_bookmarks '{
  "collection_id": 1,
  "search": "example_search",
  "page": 1,
  "per_page": 1
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs raindrop --json
kosmo integrations:docs raindrop.raindrop_list_bookmarks --json
kosmo integrations:schema raindrop.raindrop_list_bookmarks --json
kosmo integrations:search "Raindrop.io" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Raindrop.io.

`raindrop.raindrop_list_bookmarks`

Read read

List bookmarks from Raindrop.io. Optionally filter by collection or search query. Returns paginated results with bookmark details.

Parameters: collection_id, search, page, per_page

Generic CLI call

kosmo integrations:call raindrop.raindrop_list_bookmarks '{"collection_id":1,"search":"example_search","page":1,"per_page":1}' --json

Provider shortcut

kosmo integrations:raindrop raindrop_list_bookmarks '{"collection_id":1,"search":"example_search","page":1,"per_page":1}' --json

`raindrop.raindrop_get_bookmark`

Read read

Get full details of a single bookmark by its ID, including title, URL, tags, excerpt, and metadata.

Parameters: id

Generic CLI call

kosmo integrations:call raindrop.raindrop_get_bookmark '{"id":1}' --json

Provider shortcut

kosmo integrations:raindrop raindrop_get_bookmark '{"id":1}' --json

`raindrop.raindrop_create_bookmark`

Write write

Save a new bookmark to Raindrop.io. Provide a URL and optionally set the title, tags, collection, and description.

Parameters: link, title, tags, collection_id, excerpt

Generic CLI call

kosmo integrations:call raindrop.raindrop_create_bookmark '{"link":"example_link","title":"example_title","tags":"example_tags","collection_id":1,"excerpt":"example_excerpt"}' --json

Provider shortcut

kosmo integrations:raindrop raindrop_create_bookmark '{"link":"example_link","title":"example_title","tags":"example_tags","collection_id":1,"excerpt":"example_excerpt"}' --json

`raindrop.raindrop_update_bookmark`

Write write

Update an existing bookmark in Raindrop.io. Provide the bookmark ID and the fields to change (title, URL, tags, collection, description, etc.).

Parameters: id, link, title, tags, collection_id, excerpt

Generic CLI call

kosmo integrations:call raindrop.raindrop_update_bookmark '{"id":1,"link":"example_link","title":"example_title","tags":"example_tags","collection_id":1,"excerpt":"example_excerpt"}' --json

Provider shortcut

kosmo integrations:raindrop raindrop_update_bookmark '{"id":1,"link":"example_link","title":"example_title","tags":"example_tags","collection_id":1,"excerpt":"example_excerpt"}' --json

`raindrop.raindrop_list_collections`

Read read

List all bookmark collections (folders) from Raindrop.io. Returns collection names, IDs, and counts.

Parameters: none

Generic CLI call

kosmo integrations:call raindrop.raindrop_list_collections '{}' --json

Provider shortcut

kosmo integrations:raindrop raindrop_list_collections '{}' --json

`raindrop.raindrop_get_collection`

Read read

Get details of a specific collection by ID, including its name, color, icon, and bookmark count.

Parameters: id

Generic CLI call

kosmo integrations:call raindrop.raindrop_get_collection '{"id":1}' --json

Provider shortcut

kosmo integrations:raindrop raindrop_get_collection '{"id":1}' --json

`raindrop.raindrop_get_current_user`

Read read

Get the authenticated Raindrop.io user's profile — name, email, subscription plan, and storage usage.

Parameters: none

Generic CLI call

kosmo integrations:call raindrop.raindrop_get_current_user '{}' --json

Provider shortcut

kosmo integrations:raindrop raindrop_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

`raindrop.raindrop_list_bookmarks`

List bookmarks from Raindrop.io. Optionally filter by collection or search query. Returns paginated results with bookmark details.

Operation: Read read
Schema command: kosmo integrations:schema raindrop.raindrop_list_bookmarks --json

Parameter	Type	Required	Description
`collection_id`	integer	no	Collection ID to filter by. Use 0 for all bookmarks, -1 for unsorted, -99 for trash. Omit to list all.
`search`	string	no	Search query to filter bookmarks by keyword.
`page`	integer	no	Page number for pagination (starts at 1, default: 1).
`per_page`	integer	no	Number of results per page (max 50, default: 25).

`raindrop.raindrop_get_bookmark`

Get full details of a single bookmark by its ID, including title, URL, tags, excerpt, and metadata.

Operation: Read read
Schema command: kosmo integrations:schema raindrop.raindrop_get_bookmark --json

Parameter	Type	Required	Description
`id`	integer	yes	The bookmark ID.

`raindrop.raindrop_create_bookmark`

Save a new bookmark to Raindrop.io. Provide a URL and optionally set the title, tags, collection, and description.

Operation: Write write
Schema command: kosmo integrations:schema raindrop.raindrop_create_bookmark --json

Parameter	Type	Required	Description
`link`	string	yes	The URL to bookmark.
`title`	string	no	Title for the bookmark. If omitted, Raindrop will auto-detect from the page.
`tags`	array	no	Tags to assign to the bookmark (array of strings).
`collection_id`	integer	no	Collection ID to save into. Use 0 or omit for "Unsorted".
`excerpt`	string	no	A short description or note for the bookmark.

`raindrop.raindrop_update_bookmark`

Update an existing bookmark in Raindrop.io. Provide the bookmark ID and the fields to change (title, URL, tags, collection, description, etc.).

Operation: Write write
Schema command: kosmo integrations:schema raindrop.raindrop_update_bookmark --json

Parameter	Type	Required	Description
`id`	integer	yes	The bookmark ID to update.
`link`	string	no	New URL for the bookmark.
`title`	string	no	New title for the bookmark.
`tags`	array	no	Replace tags (array of strings).
`collection_id`	integer	no	Move to a different collection by providing its ID.
`excerpt`	string	no	New description or note.

`raindrop.raindrop_list_collections`

List all bookmark collections (folders) from Raindrop.io. Returns collection names, IDs, and counts.

Operation: Read read
Schema command: kosmo integrations:schema raindrop.raindrop_list_collections --json

Parameter	Type	Required	Description
No parameters.

`raindrop.raindrop_get_collection`

Get details of a specific collection by ID, including its name, color, icon, and bookmark count.

Operation: Read read
Schema command: kosmo integrations:schema raindrop.raindrop_get_collection --json

Parameter	Type	Required	Description
`id`	integer	yes	The collection ID.

`raindrop.raindrop_get_current_user`

Get the authenticated Raindrop.io user's profile — name, email, subscription plan, and storage usage.

Operation: Read read
Schema command: kosmo integrations:schema raindrop.raindrop_get_current_user --json

Parameter	Type	Required	Description
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.