storage
Dropbox MCP Integration for Claude Agent SDK
Connect Dropbox to Claude Agent SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.
17 functions 10 read 7 write Manual OAuth token auth
Connect Dropbox to Claude Agent SDK
Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server.
Add a KosmoKrator stdio MCP server to the Claude Agent SDK options. The gateway is local, scoped to this integration, and starts with
--write=deny so Claude Agent SDK can inspect read-capable tools without receiving write access by default.
Dropbox MCP Config for Claude Agent SDK
Use a narrow integration list so the agent does not load unrelated tools.
{
"mcpServers": {
"kosmokrator-dropbox": {
"type": "stdio",
"command": "kosmo",
"args": [
"mcp:serve",
"--integration=dropbox",
"--write=deny"
]
}
}
}Run the Gateway Manually
kosmokrator mcp:serve --integration=dropbox --write=denyWhy Use KosmoKrator Here
Scoped tools
Expose only Dropbox instead of a broad multi-service tool list.
Local credentials
Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.
Write policy
Start read-only, then opt into ask or allow for trusted workspaces.
Dropbox Tools Visible to Claude Agent SDK
Claude Agent SDK sees stable MCP tool names generated from the Dropbox integration catalog.
| MCP tool | Source function | Type | Description |
|---|---|---|---|
integration__dropbox__dropbox_list_folder | dropbox.dropbox_list_folder | 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. |
integration__dropbox__dropbox_list_folder_continue | dropbox.dropbox_list_folder_continue | Read | 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. |
integration__dropbox__dropbox_upload_file | dropbox.dropbox_upload_file | Write | 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"). |
integration__dropbox__dropbox_download_file | dropbox.dropbox_download_file | Read | Download a file from Dropbox. Returns the raw file content. The path must reference a file (not a folder). |
integration__dropbox__dropbox_create_folder | dropbox.dropbox_create_folder | Write | 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. |
integration__dropbox__dropbox_delete | dropbox.dropbox_delete | Write | 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. |
integration__dropbox__dropbox_move | dropbox.dropbox_move | Write | 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. |
integration__dropbox__dropbox_copy | dropbox.dropbox_copy | Write | 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. |
integration__dropbox__dropbox_search_files | dropbox.dropbox_search_files | Read | 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. |
integration__dropbox__dropbox_search_continue | dropbox.dropbox_search_continue | Read | 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. |
integration__dropbox__dropbox_create_shared_link | dropbox.dropbox_create_shared_link | Write | Create a shared link for a file or folder in Dropbox. Optionally configure link settings such as access level, password, and expiry. |
integration__dropbox__dropbox_list_shared_links | dropbox.dropbox_list_shared_links | Read | List shared links for a specific file or folder, or list all shared links. Optionally filter by path or paginate with a cursor. |
integration__dropbox__dropbox_get_temporary_link | dropbox.dropbox_get_temporary_link | Read | 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. |
integration__dropbox__dropbox_list_revisions | dropbox.dropbox_list_revisions | Read | 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. |
integration__dropbox__dropbox_restore | dropbox.dropbox_restore | Write | 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. |
integration__dropbox__dropbox_get_metadata | dropbox.dropbox_get_metadata | Read | 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. |
integration__dropbox__dropbox_get_current_account | dropbox.dropbox_get_current_account | Read | Get information about the currently authenticated Dropbox account, including display name, email, account type, and usage quota. |