How to connect the Dropbox remote MCP server

Updated Mar 18, 2026

In this article

person icon

This article applies to customers in an open beta and is generally available. Betas are subject to additional terms. Learn more about Dropbox products in beta.

The Dropbox MCP remote server, now in beta, makes it easy to connect Dropbox directly within your favorite apps, so you can stay focused without switching tabs or interrupting your workflow.

 

Built on the open-source Model Context Protocol (MCP) standard, this integration lets you securely access and use Dropbox inside LLM-based environments.

 

You can use the Dropbox MCP Server if you’re:

  • A developer who wants to browse or query Dropbox files from an IDE such as Cursor or Claude Code.
  • An AI agent builder connecting Dropbox as a data source for retrieval, reasoning, or workflow automation.
  • A professional using AI assistants to review documents, organize files, share content, or collect files from others.
  • A writer or researcher creating drafts, summaries, notes, or reference material using Dropbox content.
  • Using an MCP-compatible client such as Cursor, Claude, or ChatGPT to work with Dropbox files and folders.

Available tools

Tools Description
ListFolder
  • Browse directory contents (up to 100 items per call).
  • Get basic file info: name, size, modification date, file ID.
  • Navigate with pagination using cursors.
  • Handle paths with spaces and special characters.
GetFileMetadata
  • Get detailed file properties: size, dates, MIME type.
  • Works with either file paths or file IDs.  
  • Human-readable formatting (for example, "2.71 MB").
GetFileContent
  • Extract text from PDFs, Word documents, and other text representable files.
  • Support files up to 5 MB.
  • Content Links: Provides Dropbox links for all files (even when text extraction fails).
GetUsageAndQuota
  • Retrieve the current storage usage in units of bytes (total space used).
  • Retrieve the current storage quota in units of bytes (total space available).
  • Supports team users and individual users, for users that are on a team, the tool will retrieve the usage and quota for the entire team.
Search
  • Search files and folders by name or content.
  • Filter by folder, file type, or last updated date, and more.
  • Sort results by relevance or most recent changes.
  • Display more search results.
CreateFolder
  • Create a folder anywhere in Dropbox by specifying its path. 
  • The response includes folder details for easy chaining with later operations.
CreateFile
  • Create a new text-oriented file from inline UTF-8 content up to 5 MB.
  • Best suited for documents like notes, markdown, JSON, and source code.
CreateSharedLink
WhoAmI
  • Get the authenticated Dropbox user’s identity, team/account context, and root/home namespace IDs.
Copy
Move
  • Move or rename one or more files or folders in Dropbox.
  • Large jobs may run in the background.
  • Use CheckJobStatus to track progress.
Delete
CheckJobStatus
  • Check the status of a background copy, move, or delete operation.
DownloadLink
  • Create a temporary, single-use download link for one or more files.
  • Allows an MCP client to download the original file instead of reading extracted text.
ListSharedLinks
GetSharedLinkMetadata
  • View details about a shared link.
  • Includes audience, expiration date, password protection, and download settings.
CreateFileRequest
GetFileRequest
  • View details for a specific file request using its ID.
ListFileRequests
  • View file requests you own.
  • Includes the upload URL, destination folder, deadline, open state, and submitted file count.

Supported MCP clients

Dropbox MCP server supports Dynamic Client Registration for a trusted set of MCP Clients. More will be added soon. For now, here's the list of all supported MCP Clients:

 

Supported MCP Clients
Claude Code
Claude Web
ChatGPT Codex
ChatGPT Web
Cursor
highlighter icon

Notes: 

  • Request a particular MCP client to be supported by Dynamic Client Registration through Get Help.
  • No additional setup is needed before connecting to the MCP server.

How to connect to the Dropbox MCP remote server

Dropbox MCP server location: https://mcp.dropbox.com/mcp

The setup steps vary depending on your MCP client.

warning icon

Important: If you change your Dropbox app settings, such as adding a new scope, you must reconnect to the Dropbox MCP server.

Connect with Cursor

To set up the connector

  1. In Cursor, click Settings, then Cursor Settings.
  2. Click Tools and MCP, then New MCP Server.
  3. Copy the configuration below:
{
  "mcpServers": {
    "Dropbox MCP": {
      "url": "https://mcp.dropbox.com/mcp"
    }
   }
}

Connect with Claude Web/Desktop

Prerequisites

  • Access to the Claude Custom Connector (available on select Claude plans)

To set up the connector

  1. In Claude, click Settings, then Connectors.
  2. Click Add custom connector.
  3. Enter the following:
    • Name: Dropbox MCP
    • Dropbox MCP server URL: https://mcp.dropbox.com/mcp
  4. Click Add.

Connect with Claude Code (CLI)

Prerequisites

  • Claude Code CLI installed

To set up the connector

claude mcp add --transport http DropboxMCP https://mcp.dropbox.com/mcp

Connect with ChatGPT Web

Prerequisites

  • Access to ChatGPT Developer Mode (available on certain plans)

To enable Developer Mode

  1. In ChatGPT, click Settings, then Apps & Connectors.
  2. Click Advanced settings.
  3. Toggle Developer mode to ON.
  4. Review the prompt about unverified connectors, then click Confirm.

To set up the connector

  1. In ChatGPT, click Settings, then Apps.
  2. Click Create app.
  3. Enter the following:
    • Name: Dropbox MCP
    • MCP Server URL: https://mcp.dropbox.com/mcp
    • Authentication: OAuth
  4. Check I understand and want to continue.
  5. Click Create.

Connect with ChatGPT Codex (CLI)

Prerequisites

  • Codex installed locally

To set up the connector

  1. Add the connector:
codex mcp add DropboxMCP --url https://mcp.dropbox.com/mcp
2. Log in to the connector: 
codex mcp login DropboxMCP

Connecting from other MCP clients

Before connecting to the MCP server, you need a Dropbox app to obtain API credentials. Follow the Dropbox app setup instructions.

Dropbox app setup

highlighter icon

Note: Your Dropbox admin may control whether you can register or connect apps. If you don’t see the option to create an app or connect Dropbox to another service, contact your team admin. Learn more about admin controls for app integrations.

  1. Go to the Dropbox App Console.
  2. Click Create app.
  3. Configure your app:
    • API: Scoped access
    • Access type: Full Dropbox
    • App name: Choose a unique name
  4. Click Permissions, then enable:
    • files.metadata.read
    • files.content.read
    • files.content.write
    • sharing.write
    • account_info.read
    • sharing.read
    • file_requests.read
    • file_requests.write
  5. Add OAuth 2 Redirect URIs for your MCP Client:
    • Check their documentation for specific OAuth2 redirect URIs.
    • This is sometimes obtained during the setup flow of connecting to MCP servers.
  6. Collect your credentials:
    • Click Settings.
    • Click Generate access token.
    • Copy your Access token.
      • Note: The access token is short-lived, so you’ll need to regenerate it when it expires.
    • Copy the App key.
    • Copy the App secret.
  7. Customize your app in Branding with a name, icon, and description (Optional).

FAQs

How secure is the connection?

Dropbox MCP uses Dropbox OAuth for secure authentication. Your data stays protected under Dropbox’s existing privacy and security standards.

Was this article helpful?

Let us know how why it didn't help:

Thanks for letting us know!

Thanks for your feedback!

Related Articles

Add Dropbox to the Files app on your Chromebook

Manage third-party apps

What is the Dropbox App Center?

What is the Dropbox Business API, and what apps are available for my team?

Other ways to get help

Icon depicting two people
Community
Icon depicting a speech bubble
Contact support
Twitter Icon
Social media support