Skip to main content

Dropbox MCP Server

The Dropbox MCP server lets your AI agents perform read-only operations on a user's Dropbox account. Agents can browse files and folders, read metadata, search for content, retrieve download links, and check storage usage.

Capabilities

ToolWhat It Does
List foldersBrowse the contents of a folder
Get file/folder metadataRetrieve details about a specific file or folder
Search filesSearch for files and folders by name
Get download linkRetrieve a temporary download link for a file
Get space usageCheck storage usage for the account

📝 Note: The Dropbox integration is intentionally read-only. It does not support creating, modifying, or deleting files.

OAuth Setup

The Dropbox MCP server uses OAuth to authenticate on behalf of each user. To enable this integration, you need to create a Dropbox App in the Dropbox developer console.

Step 1: Create a Dropbox App

  1. Go to the Dropbox App Console and sign in.
  2. Click Create app.
  3. Choose Scoped access.
  4. Select Full Dropbox (access to all files and folders) or App Folder (restricted to a single folder) based on your use case.
  5. Enter a name for the app and click Create app.

Step 2: Get Your Credentials

  1. Open your app in the App Console.
  2. Go to the Settings tab.
  3. Copy the App key (this is your Client ID) and App secret (this is your Client Secret).

Step 3: Configure the Redirect URL

  1. In the Settings tab, locate OAuth 2 > Redirect URIs.
  2. Add the redirect URL provided by your Devs.ai platform administrator.

Step 4: Enable Required Scopes

  1. Go to the Permissions tab in the App Console.
  2. Enable the following scopes:
ScopeDescription
files.metadata.readView metadata for files and folders, list and search directory contents
files.content.readRead file contents via temporary download links
account_info.readView account profile and storage usage
  1. Click Submit to save the permissions.

Step 5: Configure in Devs.ai

  1. Navigate to Organization > Connectors in Devs.ai.
  2. Find the Dropbox template and click Enable.
  3. Select OAuth as the authentication type.
  4. Enter your App key (Client ID) and App secret (Client Secret) from Step 2.
  5. Select the tools you want to make available.
  6. Click Save.

OAuth Configuration Reference

FieldValue
Authorization URLhttps://www.dropbox.com/oauth2/authorize
Token URLhttps://api.dropboxapi.com/oauth2/token
Scopes Parameter Namescope (space-separated)

Additional Resources

⌘J