data
Dropbox MCP, CLI, and Lua Integration for AI Agents
Dropbox integration docs for AI agents: MCP gateway setup, Dropbox CLI commands, Lua API reference, credentials, and function schemas.Dropbox for agents
Credentials can be configured manually in web or CLI hosts.
Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.
Agent Surfaces
Machine-Readable Metadata
Function Catalog
| Function | Type | Parameters | Description |
|---|---|---|---|
dropbox.dropbox_list_folder | Read read | 3 | 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 read | 1 | 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 write | 5 | 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 read | 1 | Download a file from Dropbox. Returns the raw file content. The path must reference a file (not a folder). |
dropbox.dropbox_create_folder | Write write | 2 | 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 write | 1 | 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 write | 4 | 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 write | 4 | 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 read | 4 | 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 read | 1 | 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 write | 2 | 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 read | 2 | 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 read | 1 | 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 read | 2 | 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 write | 2 | 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 read | 3 | 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 read | 0 | Get information about the currently authenticated Dropbox account, including display name, email, account type, and usage quota. |