Connect your AI Agents to Dropbox in minutes
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
validate_credential
Validate Dropbox credentials. Verifies credentials during setup.
How to set up Merge Agent Handler
In an mcp.json file, add the configuration below, and restart Cursor.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5 "headers": {
6 "Authorization": "Bearer yMt*****"
7 }
8 }
9 }
10}
11Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.
Make sure Claude is using the Node v20+.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "yMt*****"
14 }
15 }
16 }
17}Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "<ah-production-access-key>"
14 }
15 }
16 }
17 }In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".
You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.
Learn more in the official documentation ↗
1{
2 "inputs": [
3 {
4 "type": "promptString",
5 "id": "agent-handler-auth",
6 "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7 "password": true
8 }
9 ],
10 "servers": {
11 "agent-handler": {
12 "type": "stdio",
13 "command": "npx",
14 "args": [
15 "-y",
16 "mcp-remote@latest",
17 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18 "--header",
19 "Authorization: Bearer ${input:agent-handler-auth}"
20 ]
21 }
22 }
23}FAQs on using Merge's Dropbox MCP server
FAQs on using Merge's Dropbox MCP server
Ready to try it out?
Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now
