Overview
What is dbx-mcp-server?
dbx-mcp-server is a Model Context Protocol (MCP) server that provides integration with Dropbox, allowing MCP-compatible clients to interact with Dropbox through a set of file, search, and account tools. It is an independent, unofficial integration that works with Dropbox's public API.
How to use dbx-mcp-server?
Clone the repository, run npm install and npm run build, register a Dropbox app with required permissions, run npm run setup, then add the server to your MCP client settings using the command node with args ["/path/to/dbx-mcp-server/build/index.js"]. Set the required environment variables: DROPBOX_APP_KEY, DROPBOX_APP_SECRET, DROPBOX_REDIRECT_URI, and TOKEN_ENCRYPTION_KEY.
Key features of dbx-mcp-server
- List, upload, and download files in Dropbox
- Create, copy, move, and safely delete files and folders
- Search files and folders by query
- Generate sharing links for files or folders
- Retrieve file metadata and account information
Use cases of dbx-mcp-server
- Allow an LLM-based assistant to browse and retrieve files from Dropbox
- Automate file organization, uploads, and deletions via natural language commands
- Enable searching across Dropbox content without leaving the chat interface
- Generate shareable links for collaboration directly through an MCP client
FAQ from dbx-mcp-server
Is dbx-mcp-server officially affiliated with Dropbox?
No, this project is not affiliated with, endorsed by, or sponsored by Dropbox. It is an independent integration using Dropbox's public API.
What authentication method does dbx-mcp-server use?
It uses OAuth 2.0 with PKCE for secure authentication with Dropbox. Tokens are encrypted using the TOKEN_ENCRYPTION_KEY environment variable.
What runtime and dependencies does dbx-mcp-server require?
It requires Node.js, is built with TypeScript and the Model Context Protocol SDK, and uses Dropbox SDK v10.34.0 and Dropbox API v2.
How do I configure my MCP client to use dbx-mcp-server?
Add an entry to your MCP settings file under mcpServers with command: "node" and args pointing to the built index.js file, for example ["/path/to/dbx-mcp-server/build/index.js"].
