bookmarks
Raindrop.io CLI for Headless Automation
Use the Raindrop.io CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
7 functions 5 read 2 write Bearer token auth
Raindrop.io CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The Raindrop.io CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Raindrop.io CLI for Headless Automation
kosmokrator integrations:configure raindrop --set access_token="$RAINDROP_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call raindrop.raindrop_list_bookmarks '{"collection_id":1,"search":"example_search","page":1,"per_page":1}' --json Discovery Before Execution
Agents and scripts can inspect Raindrop.io docs and schemas 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 Useful Raindrop.io CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
raindrop.raindrop_list_bookmarks | Read | collection_id, search, page, per_page | List bookmarks from Raindrop.io. Optionally filter by collection or search query. Returns paginated results with bookmark details. |
raindrop.raindrop_get_bookmark | Read | id | Get full details of a single bookmark by its ID, including title, URL, tags, excerpt, and metadata. |
raindrop.raindrop_create_bookmark | Write | link, title, tags, collection_id, excerpt | Save a new bookmark to Raindrop.io. Provide a URL and optionally set the title, tags, collection, and description. |
raindrop.raindrop_update_bookmark | Write | id, link, title, tags, collection_id, excerpt | Update an existing bookmark in Raindrop.io. Provide the bookmark ID and the fields to change (title, URL, tags, collection, description, etc.). |
raindrop.raindrop_list_collections | Read | none | List all bookmark collections (folders) from Raindrop.io. Returns collection names, IDs, and counts. |
raindrop.raindrop_get_collection | Read | id | Get details of a specific collection by ID, including its name, color, icon, and bookmark count. |
raindrop.raindrop_get_current_user | Read | none | Get the authenticated Raindrop.io user's profile — name, email, subscription plan, and storage usage. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.