dropbox

This Dropbox MCP Server provides a bridge between Claude-style assistants and Dropbox, exposing a set of MCP-compatible tools to interact with Dropbox resources. The server implements authentication via OAuth 2.0, enabling operations such as listing, searching, downloading, uploading, moving, copying, and deleting files, as well as folder creation, sharing links, and basic version control actions like retrieving revisions and restoring previous states. Tools are exposed as commands that Claude can invoke (for example dropbox_list, dropbox_upload, dropbox_get_metadata, dropbox_create_shared_link, dropbox_get_revisions, etc.). To use it, first authenticate with Dropbox (dropbox_auth), then call the available dropbox_* commands through Claude via the MCP interface or by invoking the CLI utilities provided by the server.

Prerequisites:

• A Dropbox account and the corresponding Dropbox App credentials (Client ID and Client Secret)
• Go 1.21 or higher for building from source
• Optional: pre-built binaries or Homebrew formula if available

Option 1: Install with Go (build from source)

git clone https://github.com/ngs/dropbox-mcp-server.git
cd dropbox-mcp-server
go build -o dropbox-mcp-server

Option 2: Install with Homebrew (macOS/Linux) [if a formula is published]

brew tap ngs/tap
brew install dropbox-mcp-server

Option 3: Download Pre-built Binary

• Download the latest release from the releases page
• Extract and place the binary in your PATH, e.g. /usr/local/bin/

# Example (adjust for your platform)
curl -L https://github.com/ngs/dropbox-mcp-server/releases/latest/download/dropbox-mcp-server_linux_amd64.tar.gz | tar xz
sudo mv dropbox-mcp-server /usr/local/bin/

Option 4: Build from Source (alternative)

git clone https://github.com/ngs/dropbox-mcp-server.git
cd dropbox-mcp-server
go build -o dropbox-mcp-server

Configure and run the server after installation as described in the Setup/Configuration sections of the README.

• Important Security: Each user must create and use their own Dropbox App credentials. Do not embed or share CLIENT_SECRET in binaries.
• The OAuth flow requires a redirect URI (default example shown in the README is http://localhost:8080/callback). Ensure this is allowed in your Dropbox app settings.
• Configuration is stored at ~/.dropbox-mcp-server/config.json. This file contains sensitive tokens and should be protected (0600 permissions).
• If you install via Homebrew or place the binary in /usr/local/bin, you can reference the server by command name dropbox-mcp-server in configuration files. If installed elsewhere, provide the full path to the executable.
• For Claude Desktop integration, you can register the MCP server via Claude CLI or manually in Claude’s config as shown in the README. Ensure environment variables for client credentials are provided if using the CLI approach.
• If you encounter authentication or permission issues, re-check the Dropbox app scopes (files.content.read/write, files.metadata.read/write, sharing.read/write), and confirm the redirect URI is correctly configured.