Dropbox

Provides read access to Dropbox files with listing, reading, searching, and content extraction

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 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": {
    "cindyloo-dropbox-mcp-server": {
      "command": "python",
      "args": [
        "dropbox_server.py"
      ],
      "env": {
        "DROPBOX_ACCESS_TOKEN": "your_access_token_here"
      }
    }
  }
}

This MCP server provides read-only access to your Dropbox files with powerful search and content extraction capabilities. You can browse, read, and search the contents of documents like PDFs, DOCX, and plain text, making it easy to locate information across your Dropbox from any MCP client.

How to use

You connect to this MCP server from an MCP client to interact with your Dropbox data. You can list files and folders, read file contents, search by file name, and search within file content. You can also retrieve detailed metadata for a file and extract text from PDFs and DOCX documents. Use these capabilities to quickly locate documents, review their content, and gather relevant details without leaving your MCP client.

Typical workflows you’ll perform: browse a folder to understand its structure, open a document to preview its text, search for a term across multiple files, and fetch metadata to decide what action to take next. When you need deep content, request text extraction for supported file types like PDF, DOCX, and common text formats.

Start by listing files in a directory, then narrow your results with a content search or a focused file read. If you want to locate a specific document by name, use the file-name search feature and then inspect the file’s content with the read or content-search tools.

How to install

Prerequisites you need before running the server: Python 3.10 or higher, and a Dropbox account with an access token. You will also install the MCP server package along with its dependencies.

Install the MCP server package and dependencies.

pip install -e .

Or install manually with the required dependencies:

pip install mcp dropbox pydantic PyPDF2 python-docx

Configuration and environment

Set your Dropbox access token as an environment variable so the server can access your files securely.

export DROPBOX_ACCESS_TOKEN="your_access_token_here"

Running the server locally

You can run the server locally using a Python command. This starts the MCP server as a standard stdio process that you can connect to from your MCP client.

python dropbox_server.py

Available tools

list_files

List files and folders in a Dropbox directory with optional folder_path and max_files to control the scope of results.

search_files

Search for files by name with optional file_types and max_results to limit results.

read_file

Read the full content of a specified file, with optional max_length to cap the response.

get_file_info

Retrieve detailed metadata for a specific file along with its properties.

search_file_content

Search for text within the contents of specified files, with optional context_chars to include surrounding text.