KosmoKrator

storage

Dropbox CLI for Headless Automation

Use the Dropbox CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

17 functions 10 read 7 write Manual OAuth token auth
Submit Dropbox feedback View package source

Dropbox 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 Dropbox CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Dropbox CLI for Headless Automation
kosmokrator integrations:configure dropbox --set access_token="$DROPBOX_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call dropbox.dropbox_list_folder '{"path":"example_path","recursive":true,"limit":1}' --json

Discovery Before Execution

Agents and scripts can inspect Dropbox docs and schemas before choosing a function.

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

Useful Dropbox CLI Functions

FunctionTypeParametersDescription
dropbox.dropbox_list_folder Read path, recursive, limit 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.
dropbox.dropbox_list_folder_continue Read cursor 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.
dropbox.dropbox_upload_file Write path, content, mode, autorename, mute 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").
dropbox.dropbox_download_file Read path Download a file from Dropbox. Returns the raw file content. The path must reference a file (not a folder).
dropbox.dropbox_create_folder Write path, autorename 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.
dropbox.dropbox_delete Write path 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.
dropbox.dropbox_move Write from_path, to_path, autorename, allow_shared_folder 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.
dropbox.dropbox_copy Write from_path, to_path, autorename, allow_shared_folder 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.
dropbox.dropbox_search_files Read query, path, file_categories, max_results 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.
dropbox.dropbox_search_continue Read cursor 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.
dropbox.dropbox_create_shared_link Write path, settings Create a shared link for a file or folder in Dropbox. Optionally configure link settings such as access level, password, and expiry.
dropbox.dropbox_list_shared_links Read path, cursor List shared links for a specific file or folder, or list all shared links. Optionally filter by path or paginate with a cursor.
dropbox.dropbox_get_temporary_link Read path 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.
dropbox.dropbox_list_revisions Read path, limit 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.
dropbox.dropbox_restore Write path, rev 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.
dropbox.dropbox_get_metadata Read path, include_media_info, include_deleted 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.
dropbox.dropbox_get_current_account Read none Get information about the currently authenticated Dropbox account, including display name, email, account type, and usage quota.

Automation Notes

Related Dropbox CLI Pages

CI Dropbox CLI for CI. Cron Jobs Dropbox CLI for cron jobs. Shell Scripts Dropbox CLI for shell scripts. Coding Agents Dropbox CLI for coding agents.