Dropbox
How to configure the Dropbox MCP connector
The Dropbox connector allows the chatbot to search, read, and manage files in Dropbox through the official Dropbox remote MCP server.
Connector Settings
| Field | Value |
|---|---|
| Integration Type | MCP |
| Name | Dropbox |
| URL | https://mcp.dropbox.com/mcp |
| Transport Type | Streamable HTTP |
| Authentication Type | OAuth 2.1 |
| OAuth Client ID | (from Dropbox App Console) |
| OAuth Client Secret | (from Dropbox App Console) |
| OAuth Scopes | account_info.read files.metadata.read files.content.read |
This MCP server does not support Dynamic Client Registration (RFC 7591). You must provide OAuth Client ID and Client Secret from an app registered in the Dropbox App Console.
When creating the Dropbox app, choose Scoped access with Full Dropbox access. App folder access only exposes a single sandbox folder, which is not enough to read existing files.
Under OAuth 2 in the app's settings, add https://ai-platform.mitigate.dev/connector_connections/callback as a redirect URI.
Enable the scopes below on the app's Permissions tab before connecting. Scopes are baked into tokens when they are issued, so anyone who connected earlier must reconnect after they change.
New apps stay in Development status, which is fully functional but limited to 500 linked users. Apply for production status in the App Console before a wider rollout.
OAuth Scopes
Scopes are selected on the app's Permissions tab in the App Console. See the Dropbox OAuth guide for how they are grouped.
| Scope | Description |
|---|---|
account_info.read | Read the user's account information |
files.metadata.read | View names, sizes, and modification dates of files and folders |
files.content.read | View and download file content |
files.content.write | Create, edit, and delete file content — only needed for the write tools below |
sharing.read | View shared links and shared folder information |
sharing.write | Create and modify shared links |
file_requests.read | View file requests |
file_requests.write | Create and modify file requests |
Keep the connector's scopes read-only unless the write tools are genuinely needed. The file picker and document source both read the access token in the browser, so a token granted files.content.write could delete Dropbox content from the browser context.
Document Source
The Dropbox connector can also be used as a document source to ingest files from Dropbox into your knowledge base.
Usage Examples
Once connected, users can interact with Dropbox through natural language:
- "Search Dropbox for the onboarding handbook"
- "List the files in the Contracts folder"
- "Summarise the latest proposal in Dropbox"
Tools
Dropbox's remote MCP server is in beta and reports its own tool list on connection. The tools below are the ones Dropbox documents; the exact set and parameters available to an organization are shown on the connector page in the admin once it is connected.
List Folder
ListFolder
Browse the contents of a folder, up to 100 items per call, with pagination for larger folders.
Get File Metadata
GetFileMetadata
Retrieve properties for a file or folder, including size, modification dates, and MIME type.
Get File Content
GetFileContent
Extract text from a document. Supports files up to 5 MB.
Get Markdown
GetMarkdown
Convert a document to Markdown, with OCR for scanned content.
Get Transcript
GetTranscript
Transcribe an audio or video file into timestamped text.
Search
Search
Search files and folders by name or content, with filtering options.
Get Usage And Quota
GetUsageAndQuota
Report storage usage and quota, in bytes, for the user or team.
Who Am I
WhoAmI
Return the authenticated user's identity and account context.
Download Link
DownloadLink
Create a temporary, single-use download link for a file.
List File Revisions
ListFileRevisions
List up to 100 revisions of a file, newest first.
List Restore Events
ListRestoreEvents
List file and folder activity, including edits and deletions.
List Shared Links
ListSharedLinks
List the shared links owned by the signed-in user.
Get Shared Link Metadata
GetSharedLinkMetadata
Show the details of a shared link, including its protections.
Get File Request
GetFileRequest
Retrieve a specific file request by its identifier.
List File Requests
ListFileRequests
List the file requests owned by the signed-in user, with their metadata.
Create Folder
CreateFolder
Create a new folder at a given Dropbox path.
Create File
CreateFile
Create a text file from inline UTF-8 content, up to 5 MB.
Create Shared Link
CreateSharedLink
Create a shared link for a file or folder, optionally inviting up to 25 viewers by email.
Create File Request
CreateFileRequest
Create a file request so others can upload content.
Copy
Copy
Duplicate a file or folder. Large copies run as a background job.
Move
Move
Move or rename a file or folder. Large moves run as a background job.
Delete
Delete
Move a file or folder to Deleted files, where it stays recoverable depending on the account's plan.
Restore File Revision
RestoreFileRevision
Restore an earlier revision of a file to a Dropbox location.
Restore Folder
RestoreFolder
Revert a folder to an earlier state.
Check Job Status
CheckJobStatus
Check the progress of a background copy, move, delete, or restore.