home / mcp / dropbox mcp server

Dropbox MCP Server

MCP Server for Dropbox

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "amgadabdelhafez-dbx-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/dbx-mcp-server/build/index.js"
      ],
      "env": {
        "DROPBOX_APP_KEY": "YOUR_APP_KEY",
        "DROPBOX_APP_SECRET": "YOUR_APP_SECRET",
        "DROPBOX_REDIRECT_URI": "YOUR_REDIRECT_URI",
        "TOKEN_ENCRYPTION_KEY": "YOUR_32+CHAR_KEY",
        "MAX_TOKEN_REFRESH_RETRIES": "3",
        "TOKEN_REFRESH_RETRY_DELAY_MS": "1000",
        "TOKEN_REFRESH_THRESHOLD_MINUTES": "5"
      }
    }
  }
}

You have a Dropbox integration MCP server that lets clients perform file operations, metadata queries, and account actions directly against Dropbox using a secure OAuth2 PKCE flow. It streamlines automation and tooling by exposing Dropbox capabilities through the MCP interface you already use.

How to use

Start by configuring your MCP client to connect to the Dropbox MCP server. You will authenticate via OAuth 2.0 with PKCE, granting the server access to the specific Dropbox scopes you choose. After setup, you can perform common file actions such as listing, uploading, downloading, and moving files; manage folders; generate sharing links; and retrieve file metadata and account information.

How to install

# Prerequisites
- Node.js installed on your machine
- npm (comes with Node.js) or npm/yarn as preferred

# 1) Clone the repository
git clone https://github.com/your-username/dbx-mcp-server.git
cd dbx-mcp-server

# 2) Install dependencies and build
npm install
npm run build

# 3) Run the setup script
npm run setup

# 4) Add the MCP server to your MCP settings (example)
```
{
  "mcpServers": {
    "dbx": {
      "command": "node",
      "args": ["/path/to/dbx-mcp-server/build/index.js"]
    }
  }
}

Additional sections

Configuration and security follow OAuth 2.0 PKCE needs. You will provide your Dropbox app credentials and a redirect URI so the server can complete the authorization flow and store tokens securely. The server exposes a set of tools for Dropbox file management, metadata querying, and account information; you configure which scopes your app requests to minimize access.

Notes on usage patterns

- Before running, ensure you have defined the Dropbox app scopes you need (for example: files.metadata.read, files.content.read, files.content.write, sharing.write, account_info.read).- Run the server locally or deploy to your preferred environment and point your MCP client to the configured http or stdio endpoint. - Use the provided MCP entry point to launch the server and keep the process running for reliable operation.

Available tools

list_files

List files in a directory in Dropbox

upload_file

Upload a file to a path in Dropbox

download_file

Download a file from Dropbox

safe_delete_item

Safely delete items with recycle bin support

create_folder

Create a new folder in Dropbox

copy_item

Copy a file or folder within Dropbox

move_item

Move or rename a file or folder

get_file_metadata

Retrieve metadata for a file or folder

search_file_db

Search for files and folders in Dropbox

get_sharing_link

Create or retrieve sharing links

get_file_content

Retrieve the content of a file

get_account_info

Get account information