Can I use Droplr as a CLI?

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

Can I expose Droplr through MCP?

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

Where are Droplr credentials stored?

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

Can I deny write access for Droplr MCP tools?

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

productivity

Droplr CLI for AI Agents

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

6 functions 4 read 2 write Bearer token auth

Submit Droplr feedback View package source

Droplr CLI Setup

Droplr can be configured headlessly with `kosmokrator integrations:configure droplr`.

# 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 droplr --set access_token="$DROPLR_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor droplr --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`	`DROPLR_ACCESS_TOKEN`	Secret `secret`	yes	Access Token
`url`	`DROPLR_URL`	URL `url`	no	API Base URL

Call Droplr Headlessly

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

kosmo integrations:call droplr.droplr_list_drops '{
  "page": 1,
  "limit": 1,
  "type": "example_type",
  "q": "example_q"
}' --json

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

kosmo integrations:droplr droplr_list_drops '{
  "page": 1,
  "limit": 1,
  "type": "example_type",
  "q": "example_q"
}' --json

Agent Discovery Commands

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

kosmo integrations:docs droplr --json
kosmo integrations:docs droplr.droplr_list_drops --json
kosmo integrations:schema droplr.droplr_list_drops --json
kosmo integrations:search "Droplr" --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 Droplr.

`droplr.droplr_list_drops`

Read read

List drops (short links, files, images, notes) from Droplr. Supports filtering by type and search query, with pagination.

Parameters: page, limit, type, q

Generic CLI call

kosmo integrations:call droplr.droplr_list_drops '{"page":1,"limit":1,"type":"example_type","q":"example_q"}' --json

Provider shortcut

kosmo integrations:droplr droplr_list_drops '{"page":1,"limit":1,"type":"example_type","q":"example_q"}' --json

`droplr.droplr_get_drop`

Read read

Get details of a specific drop (short link, file, image, or note) by its ID.

Parameters: id

Generic CLI call

kosmo integrations:call droplr.droplr_get_drop '{"id":"example_id"}' --json

Provider shortcut

kosmo integrations:droplr droplr_get_drop '{"id":"example_id"}' --json

`droplr.droplr_create_drop`

Write write

Create a new drop (short link) in Droplr. Provide a long URL to shorten, with optional title and variant.

Parameters: link, title, variant

Generic CLI call

kosmo integrations:call droplr.droplr_create_drop '{"link":"example_link","title":"example_title","variant":"example_variant"}' --json

Provider shortcut

kosmo integrations:droplr droplr_create_drop '{"link":"example_link","title":"example_title","variant":"example_variant"}' --json

`droplr.droplr_delete_drop`

Write write

Delete a drop (short link, file, image, or note) from Droplr by its ID. This action is permanent.

Parameters: id

Generic CLI call

kosmo integrations:call droplr.droplr_delete_drop '{"id":"example_id"}' --json

Provider shortcut

kosmo integrations:droplr droplr_delete_drop '{"id":"example_id"}' --json

`droplr.droplr_list_boards`

Read read

List boards (collections of drops) from Droplr. Supports pagination.

Parameters: page, limit

Generic CLI call

kosmo integrations:call droplr.droplr_list_boards '{"page":1,"limit":1}' --json

Provider shortcut

kosmo integrations:droplr droplr_list_boards '{"page":1,"limit":1}' --json

`droplr.droplr_get_current_user`

Read read

Get the authenticated Droplr user's profile, including name, email, and plan information.

Parameters: none

Generic CLI call

kosmo integrations:call droplr.droplr_get_current_user '{}' --json

Provider shortcut

kosmo integrations:droplr droplr_get_current_user '{}' --json

Function Schemas

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

`droplr.droplr_list_drops`

List drops (short links, files, images, notes) from Droplr. Supports filtering by type and search query, with pagination.

Operation: Read read
Schema command: kosmo integrations:schema droplr.droplr_list_drops --json

Parameter	Type	Required	Description
`page`	integer	no	Page number for pagination (default: 1).
`limit`	integer	no	Number of results per page (default: 20, max: 100).
`type`	string	no	Filter by drop type: LINK, IMAGE, FILE, or NOTE.
`q`	string	no	Search query to filter drops by title or content.

`droplr.droplr_get_drop`

Get details of a specific drop (short link, file, image, or note) by its ID.

Operation: Read read
Schema command: kosmo integrations:schema droplr.droplr_get_drop --json

Parameter	Type	Required	Description
`id`	string	yes	The drop ID (the short code, e.g., "abc123").

`droplr.droplr_create_drop`

Create a new drop (short link) in Droplr. Provide a long URL to shorten, with optional title and variant.

Operation: Write write
Schema command: kosmo integrations:schema droplr.droplr_create_drop --json

Parameter	Type	Required	Description
`link`	string	yes	The long URL to shorten (e.g., "https://example.com/very/long/url").
`title`	string	no	Optional title for the drop.
`variant`	string	no	Optional variant type: "redirect" (default) or "frame" (embeds in a frame).

`droplr.droplr_delete_drop`

Delete a drop (short link, file, image, or note) from Droplr by its ID. This action is permanent.

Operation: Write write
Schema command: kosmo integrations:schema droplr.droplr_delete_drop --json

Parameter	Type	Required	Description
`id`	string	yes	The drop ID to delete (the short code, e.g., "abc123").

`droplr.droplr_list_boards`

List boards (collections of drops) from Droplr. Supports pagination.

Operation: Read read
Schema command: kosmo integrations:schema droplr.droplr_list_boards --json

Parameter	Type	Required	Description
`page`	integer	no	Page number for pagination (default: 1).
`limit`	integer	no	Number of results per page (default: 20).

`droplr.droplr_get_current_user`

Get the authenticated Droplr user's profile, including name, email, and plan information.

Operation: Read read
Schema command: kosmo integrations:schema droplr.droplr_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.