Dropbox

MCP Server for Dropbox

typescript

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "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

Built by

VeilStrat

AI signals for GTM teams