dbx-mcp-server

Name: dbx-mcp-server
Author: amgadabdelhafez

@amgadabdelhafez

Repository

About dbx-mcp-server

MCP Server for Dropbox

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "dbx": {
      "command": "node",
      "args": [
        "/path/to/dbx-mcp-server/build/index.js"
      ],
      "env": {
        "DROPBOX_APP_KEY": "",
        "DROPBOX_APP_SECRET": "",
        "DROPBOX_REDIRECT_URI": "",
        "TOKEN_ENCRYPTION_KEY": ""
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is dbx-mcp-server?

dbx-mcp-server is a Model Context Protocol (MCP) server that integrates with Dropbox, enabling MCP-compatible clients to interact with Dropbox through a set of tools. It is an independent, unaffiliated project that uses Dropbox’s public API.

How to use dbx-mcp-server?

Clone the repository, run npm install, npm run build, and npm run setup. Then configure your MCP client with the command node and the path to the built index.js file. You must register a Dropbox app, set up OAuth 2.0 with PKCE, and provide environment variables: DROPBOX_APP_KEY, DROPBOX_APP_SECRET, DROPBOX_REDIRECT_URI, and TOKEN_ENCRYPTION_KEY.

Key features of dbx-mcp-server

List, upload, download, and delete files
Create, copy, and move files and folders
Retrieve file metadata and contents
Search files and folders by query
Create sharing links
Get Dropbox account information

Use cases of dbx-mcp-server

List files in any Dropbox directory
Upload a file to a specified path
Download a file’s content
Search for files across folders
Generate shareable links for files

FAQ from dbx-mcp-server

What tools does dbx-mcp-server provide?

File operations (list, upload, download, delete, create folder, copy, move), metadata and search (get metadata, search, create sharing link, get content), and account info.

How is authentication handled?

It uses OAuth 2.0 with PKCE. You must supply a Dropbox app key, secret, redirect URI, and an encryption key for tokens.

What Dropbox permissions are required?

Scopes include files.metadata.read, files.content.read, files.content.write, sharing.write, and account_info.read. Additional optional scopes are listed in the README.