Can I use Dropbox as a CLI?

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

Can I expose Dropbox through MCP?

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

Where are Dropbox credentials stored?

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

Can I deny write access for Dropbox MCP tools?

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

data

Dropbox CLI for AI Agents

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

Dropbox CLI Setup

Dropbox can be configured headlessly with `kosmokrator integrations:configure dropbox`.

Install, configure, and verify

# 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 dropbox --set access_token="$DROPBOX_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor dropbox --json
kosmokrator integrations:status --json

Credentials

Authentication type: Manual OAuth token oauth2_manual_token. Configure credentials once, then reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.

Key	Env var	Type	Required	Label
`access_token`	`DROPBOX_ACCESS_TOKEN`	Secret `secret`	yes	Access Token

Command Patterns

The generic command is stable across every integration. The provider shortcut is shorter for humans.

Generic CLI call

kosmo integrations:call dropbox.dropbox_list_folder '{"path":"example_path","recursive":true,"limit":1}' --json

Provider shortcut

kosmo integrations:dropbox dropbox_list_folder '{"path":"example_path","recursive":true,"limit":1}' --json

Discovery

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

Discovery commands

kosmo integrations:docs dropbox --json
kosmo integrations:docs dropbox.dropbox_list_folder --json
kosmo integrations:schema dropbox.dropbox_list_folder --json
kosmo integrations:search "Dropbox" --json
kosmo integrations:list --json

Automation Contexts

The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.

CI Run integration calls from CI jobs with JSON output, explicit credentials, and predictable exit status. Cron Jobs Schedule repeatable integration workflows from cron while keeping credentials in KosmoKrator config. Shell Scripts Call integration functions from shell scripts with stable JSON input and output. Headless Automation Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers. Coding Agents Let coding agents discover schemas and execute integration functions through CLI commands or MCP.

CLI Functions

Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.

`dropbox.dropbox_list_folder`

List files and folders in a Dropbox directory. Use an empty string "" for the root path. Returns entries with name, path, size, and type. Use recursive=true to list all nested content. If has_more is true in the response, use dropbox_list_folder_continue with the cursor to fetch additional results.

Read read

Parameters: path, recursive, limit

Generic call

kosmo integrations:call dropbox.dropbox_list_folder '{"path":"example_path","recursive":true,"limit":1}' --json

Shortcut

kosmo integrations:dropbox dropbox_list_folder '{"path":"example_path","recursive":true,"limit":1}' --json

`dropbox.dropbox_list_folder_continue`

Continue listing files and folders using the cursor from a previous dropbox_list_folder or dropbox_list_folder_continue call. Use this when the previous response has has_more=true.

Read read

Parameters: cursor

Generic call

kosmo integrations:call dropbox.dropbox_list_folder_continue '{"cursor":"example_cursor"}' --json

Shortcut

kosmo integrations:dropbox dropbox_list_folder_continue '{"cursor":"example_cursor"}' --json

`dropbox.dropbox_upload_file`

Upload a file to Dropbox. The file content is sent as the request body. Supports add (default), overwrite, and update write modes. The path must start with a slash (e.g., "/Documents/report.txt").

Write write

Parameters: path, content, mode, autorename, mute

Generic call

kosmo integrations:call dropbox.dropbox_upload_file '{"path":"example_path","content":"example_content","mode":"example_mode","autorename":true,"mute":true}' --json

Shortcut

kosmo integrations:dropbox dropbox_upload_file '{"path":"example_path","content":"example_content","mode":"example_mode","autorename":true,"mute":true}' --json

`dropbox.dropbox_download_file`

Download a file from Dropbox. Returns the raw file content. The path must reference a file (not a folder).

Read read

Parameters: path

Generic call

kosmo integrations:call dropbox.dropbox_download_file '{"path":"example_path"}' --json

Shortcut

kosmo integrations:dropbox dropbox_download_file '{"path":"example_path"}' --json

`dropbox.dropbox_create_folder`

Create a new folder in Dropbox at the specified path. Parent folders are created automatically. Set autorename to true to avoid conflicts with existing folders.

Write write

Parameters: path, autorename

Generic call

kosmo integrations:call dropbox.dropbox_create_folder '{"path":"example_path","autorename":true}' --json

Shortcut

kosmo integrations:dropbox dropbox_create_folder '{"path":"example_path","autorename":true}' --json

`dropbox.dropbox_delete`

Delete a file or folder at the given path in Dropbox. This action can be undone within the recovery window by restoring the file from revisions.

Write write

Parameters: path

Generic call

kosmo integrations:call dropbox.dropbox_delete '{"path":"example_path"}' --json

Shortcut

kosmo integrations:dropbox dropbox_delete '{"path":"example_path"}' --json

`dropbox.dropbox_move`

Move a file or folder to a new location in Dropbox. Both from_path and to_path are required. Set allow_shared_folder to true to move shared folders.

Write write

Parameters: from_path, to_path, autorename, allow_shared_folder

Generic call

kosmo integrations:call dropbox.dropbox_move '{"from_path":"example_from_path","to_path":"example_to_path","autorename":true,"allow_shared_folder":true}' --json

Shortcut

kosmo integrations:dropbox dropbox_move '{"from_path":"example_from_path","to_path":"example_to_path","autorename":true,"allow_shared_folder":true}' --json

`dropbox.dropbox_copy`

Copy a file or folder to a new location in Dropbox. Both from_path and to_path are required. Set allow_shared_folder to true to copy shared folders.

Write write

Parameters: from_path, to_path, autorename, allow_shared_folder

Generic call

kosmo integrations:call dropbox.dropbox_copy '{"from_path":"example_from_path","to_path":"example_to_path","autorename":true,"allow_shared_folder":true}' --json

Shortcut

kosmo integrations:dropbox dropbox_copy '{"from_path":"example_from_path","to_path":"example_to_path","autorename":true,"allow_shared_folder":true}' --json

`dropbox.dropbox_search_files`

Search for files and folders in Dropbox by name or content. Returns matching entries with metadata. Optionally filter by path or file category. If has_more is true, use dropbox_search_continue with the cursor.

Read read

Parameters: query, path, file_categories, max_results

Generic call

kosmo integrations:call dropbox.dropbox_search_files '{"query":"example_query","path":"example_path","file_categories":"example_file_categories","max_results":1}' --json

Shortcut

kosmo integrations:dropbox dropbox_search_files '{"query":"example_query","path":"example_path","file_categories":"example_file_categories","max_results":1}' --json

`dropbox.dropbox_search_continue`

Continue a search using the cursor from a previous dropbox_search_files or dropbox_search_continue call. Use when the previous response has has_more=true.

Read read

Parameters: cursor

Generic call

kosmo integrations:call dropbox.dropbox_search_continue '{"cursor":"example_cursor"}' --json

Shortcut

kosmo integrations:dropbox dropbox_search_continue '{"cursor":"example_cursor"}' --json

`dropbox.dropbox_create_shared_link`

Create a shared link for a file or folder in Dropbox. Optionally configure link settings such as access level, password, and expiry.

Write write

Parameters: path, settings

Generic call

kosmo integrations:call dropbox.dropbox_create_shared_link '{"path":"example_path","settings":"example_settings"}' --json

Shortcut

kosmo integrations:dropbox dropbox_create_shared_link '{"path":"example_path","settings":"example_settings"}' --json

`dropbox.dropbox_list_shared_links`

List shared links for a specific file or folder, or list all shared links. Optionally filter by path or paginate with a cursor.

Read read

Parameters: path, cursor

Generic call

kosmo integrations:call dropbox.dropbox_list_shared_links '{"path":"example_path","cursor":"example_cursor"}' --json

Shortcut

kosmo integrations:dropbox dropbox_list_shared_links '{"path":"example_path","cursor":"example_cursor"}' --json

`dropbox.dropbox_get_temporary_link`

Get a temporary link to stream a file from Dropbox. The link expires after a short time. Returns both the file metadata and the temporary link URL.

Read read

Parameters: path

Generic call

kosmo integrations:call dropbox.dropbox_get_temporary_link '{"path":"example_path"}' --json

Shortcut

kosmo integrations:dropbox dropbox_get_temporary_link '{"path":"example_path"}' --json

`dropbox.dropbox_list_revisions`

List revisions of a file in Dropbox. Returns previous versions with revision IDs that can be used with dropbox_restore to recover an earlier version.

Read read

Parameters: path, limit

Generic call

kosmo integrations:call dropbox.dropbox_list_revisions '{"path":"example_path","limit":1}' --json

Shortcut

kosmo integrations:dropbox dropbox_list_revisions '{"path":"example_path","limit":1}' --json

`dropbox.dropbox_restore`

Restore a file to a specific revision in Dropbox. Use dropbox_list_revisions to find the revision ID, then restore the file to that version.

Write write

Parameters: path, rev

Generic call

kosmo integrations:call dropbox.dropbox_restore '{"path":"example_path","rev":"example_rev"}' --json

Shortcut

kosmo integrations:dropbox dropbox_restore '{"path":"example_path","rev":"example_rev"}' --json

`dropbox.dropbox_get_metadata`

Get metadata for a file or folder in Dropbox. Returns name, path, size, modified time, and type. Optionally include media info for photos/videos or include deleted files.

Read read

Parameters: path, include_media_info, include_deleted

Generic call

kosmo integrations:call dropbox.dropbox_get_metadata '{"path":"example_path","include_media_info":true,"include_deleted":true}' --json

Shortcut

kosmo integrations:dropbox dropbox_get_metadata '{"path":"example_path","include_media_info":true,"include_deleted":true}' --json

`dropbox.dropbox_get_current_account`

Get information about the currently authenticated Dropbox account, including display name, email, account type, and usage quota.

Read read

Parameters: none

Generic call

kosmo integrations:call dropbox.dropbox_get_current_account '{}' --json

Shortcut

kosmo integrations:dropbox dropbox_get_current_account '{}' --json

Function Schemas

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

dropbox.dropbox_list_folder 3 parameters

Schema command

kosmo integrations:schema dropbox.dropbox_list_folder --json

Parameter	Type	Required	Description
`path`	string	no	Path to the folder. Use empty string "" for root, "/Photos" for the Photos folder.
`recursive`	boolean	no	If true, list all nested content recursively. Default: false.
`limit`	integer	no	Maximum number of entries to return per call (1-2000). Default: 1000.

dropbox.dropbox_list_folder_continue 1 parameters

Schema command

kosmo integrations:schema dropbox.dropbox_list_folder_continue --json

Parameter	Type	Required	Description
`cursor`	string	yes	The cursor returned by the previous list_folder or list_folder_continue call.

dropbox.dropbox_upload_file 5 parameters

Schema command

kosmo integrations:schema dropbox.dropbox_upload_file --json

Parameter	Type	Required	Description
`path`	string	yes	Destination path in Dropbox, e.g. "/Documents/report.txt". Must start with a slash.
`content`	string	yes	The raw file content to upload.
`mode`	string	no	Write mode: "add" (default, no overwrite), "overwrite", or "update" (append to existing).
`autorename`	boolean	no	If true and a file already exists, Dropbox will auto-rename. Default: false.
`mute`	boolean	no	If true, suppresses notifications on the file. Default: false.

dropbox.dropbox_download_file 1 parameters

Schema command

kosmo integrations:schema dropbox.dropbox_download_file --json

Parameter	Type	Required	Description
`path`	string	yes	Path to the file in Dropbox, e.g. "/Documents/report.txt".

dropbox.dropbox_create_folder 2 parameters

Schema command

kosmo integrations:schema dropbox.dropbox_create_folder --json

Parameter	Type	Required	Description
`path`	string	yes	Path for the new folder, e.g. "/Projects/NewProject".
`autorename`	boolean	no	If true and a folder with the same name exists, auto-rename. Default: false.

dropbox.dropbox_delete 1 parameters

Schema command

kosmo integrations:schema dropbox.dropbox_delete --json

Parameter	Type	Required	Description
`path`	string	yes	Path to the file or folder to delete, e.g. "/Documents/old_report.txt".

dropbox.dropbox_move 4 parameters

Schema command

kosmo integrations:schema dropbox.dropbox_move --json

Parameter	Type	Required	Description
`from_path`	string	yes	Current path of the file or folder, e.g. "/Documents/report.txt".
`to_path`	string	yes	Destination path, e.g. "/Archive/report.txt".
`autorename`	boolean	no	If true and a file exists at to_path, auto-rename. Default: false.
`allow_shared_folder`	boolean	no	If true, allows moving shared folders. Default: false.

dropbox.dropbox_copy 4 parameters

Schema command

kosmo integrations:schema dropbox.dropbox_copy --json

Parameter	Type	Required	Description
`from_path`	string	yes	Source path of the file or folder, e.g. "/Documents/report.txt".
`to_path`	string	yes	Destination path, e.g. "/Backup/report.txt".
`autorename`	boolean	no	If true and a file exists at to_path, auto-rename. Default: false.
`allow_shared_folder`	boolean	no	If true, allows copying shared folders. Default: false.

dropbox.dropbox_search_files 4 parameters

Schema command

kosmo integrations:schema dropbox.dropbox_search_files --json

Parameter	Type	Required	Description
`query`	string	yes	The search query string.
`path`	string	no	Optional path to scope the search, e.g. "/Documents".
`file_categories`	array	no	Filter by file categories, e.g. ["document", "image"]. Possible values: document, image, pdf, spreadsheet, presentation, audio, video, folder, paper.
`max_results`	integer	no	Maximum number of results to return (1-1000). Default: 100.

dropbox.dropbox_search_continue 1 parameters

Schema command

kosmo integrations:schema dropbox.dropbox_search_continue --json

Parameter	Type	Required	Description
`cursor`	string	yes	The cursor returned by the previous search call.

dropbox.dropbox_create_shared_link 2 parameters

Schema command

kosmo integrations:schema dropbox.dropbox_create_shared_link --json

Parameter	Type	Required	Description
`path`	string	yes	Path to the file or folder to share, e.g. "/Photos/vacation.jpg".
`settings`	object	no	Link settings object. Keys: requested_visibility ("public", "team_only", "password"), link_password, expires (timestamp), audience, access.

dropbox.dropbox_list_shared_links 2 parameters

Schema command

kosmo integrations:schema dropbox.dropbox_list_shared_links --json

Parameter	Type	Required	Description
`path`	string	no	Path to a file or folder to filter links. Omit to list all shared links.
`cursor`	string	no	Cursor for pagination from a previous response.

dropbox.dropbox_get_temporary_link 1 parameters

Schema command

kosmo integrations:schema dropbox.dropbox_get_temporary_link --json

Parameter	Type	Required	Description
`path`	string	yes	Path to the file, e.g. "/Documents/report.pdf".

dropbox.dropbox_list_revisions 2 parameters

Schema command

kosmo integrations:schema dropbox.dropbox_list_revisions --json

Parameter	Type	Required	Description
`path`	string	yes	Path to the file, e.g. "/Documents/report.txt".
`limit`	integer	no	Maximum number of revisions to return (1-100). Default: 10.

dropbox.dropbox_restore 2 parameters

Schema command

kosmo integrations:schema dropbox.dropbox_restore --json

Parameter	Type	Required	Description
`path`	string	yes	Path to the file to restore, e.g. "/Documents/report.txt".
`rev`	string	yes	The revision ID to restore to, obtained from dropbox_list_revisions.

dropbox.dropbox_get_metadata 3 parameters

Schema command

kosmo integrations:schema dropbox.dropbox_get_metadata --json

Parameter	Type	Required	Description
`path`	string	yes	Path to the file or folder, e.g. "/Documents/report.txt".
`include_media_info`	boolean	no	If true, include media metadata (dimensions, GPS, etc.) for photos and videos. Default: false.
`include_deleted`	boolean	no	If true, include deleted files in the response. Default: false.

dropbox.dropbox_get_current_account 0 parameters

Schema command

kosmo integrations:schema dropbox.dropbox_get_current_account --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.