> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Dropbox

**Authentication:** OAuth. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* Find every file in `/Sales/Proposals` modified in the last 7 days.
* Share the `Customer Onboarding` folder with view-only access to [onboarding@acme.com](mailto:onboarding@acme.com).
* Move all files older than 1 year from `/Active` to `/Archive`.

## Available Tools

#### list\_folder

List contents of a Dropbox folder with support for recursive listing and pagination

#### list\_folder\_continue

Continue paginating through folder contents using cursor from previous list\_folder response

#### get\_file\_metadata

Get detailed metadata for a specific file or folder in Dropbox by path

#### create\_folder

Create a new folder at the specified path in Dropbox with auto-rename support

#### delete\_file\_or\_folder

Delete a file or folder from Dropbox, moving it to trash for recovery

#### copy\_file\_or\_folder

Copy a file or folder to a new location within Dropbox, preserving metadata

#### move\_file\_or\_folder

Move or rename a file or folder to a new path within Dropbox

#### search\_files

Search for files and folders in Dropbox by filename or content with advanced filtering

#### search\_continue

Continue paginating through search results using cursor from previous search

#### get\_temporary\_link

Generate a temporary download link for a file that expires after 4 hours

#### list\_file\_revisions

List all saved revisions of a file for version history and recovery

#### restore\_file\_revision

Restore a file to a specific previous revision from version history

#### upload\_file

Upload a file to Dropbox with content and metadata options

#### create\_shared\_link

Create a shareable link for a file or folder with customizable access settings and expiration

#### list\_shared\_links

List all shared links created by the user with optional path filtering and pagination

#### revoke\_shared\_link

Revoke an existing shared link to immediately disable access via that URL

#### share\_folder

Share a folder with team members or anyone, enabling collaboration with access control

#### unshare\_folder

Stop sharing a folder and optionally leave a copy for existing members

#### add\_folder\_member

Add members to a shared folder with specified access level and optional custom message

#### remove\_folder\_member

Remove a member's access to a shared folder with optional copy retention

#### list\_folder\_members

List all members, groups, and pending invitations for a shared folder

#### mount\_shared\_folder

Mount a shared folder to make it appear in your Dropbox file system

#### unmount\_shared\_folder

Unmount a shared folder to remove it from your Dropbox file system view

#### get\_current\_account

Get detailed information about the currently authenticated Dropbox user account

#### get\_account

Get detailed account information for a specific Dropbox user by account ID

#### get\_account\_batch

Get account information for multiple Dropbox users in a single batch request

#### get\_space\_usage

Get current storage space usage and allocation for the authenticated user account