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 can be configured headlessly with `kosmokrator integrations:configure dropbox`.
# 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 --jsonkosmokrator integrations:doctor dropbox --jsonkosmokrator integrations:status --json
Credentials
Authentication type: Manual OAuth tokenoauth2_manual_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
DROPBOX_ACCESS_TOKEN
Secret secret
yes
Access Token
Call Dropbox Headlessly
Use the generic call form when another coding CLI or script needs a stable universal interface.
Every function below can be called headlessly. The generic form is stable across all integrations;
the provider shortcut is shorter but specific to Dropbox.
dropbox.dropbox_list_folder
Read read
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.
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.
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").
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.
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.
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.
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.
Use these parameter tables when building CLI payloads without calling integrations:schema first.
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.
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
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.
The cursor returned by the previous list_folder or list_folder_continue call.
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").
Path to the file in Dropbox, e.g. "/Documents/report.txt".
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.
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
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.
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
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.
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
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.
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.
