storage
Dropbox MCP Integration for Codex
Connect Dropbox to Codex 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 Codex
Use KosmoKrator as a local MCP proxy for Codex so coding sessions can reach selected integrations with explicit write policy.
Register kosmo mcp:serve as a local stdio server and choose the integration allowlist. The gateway is local, scoped to this integration, and starts with
--write=deny so Codex can inspect read-capable tools without receiving write access by default.
Dropbox MCP Config for Codex
Keep write access denied or ask-based unless the workspace is trusted.
{
"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 Codex
Codex 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. |