Provides read access to Dropbox files with capabilities for browsing directories, reading various file types (PDF, DOCX, TXT, code files), searching files by name, searching text content within files, and extracting metadata from files stored in Dropbox.
Dropbox MCP Server
A Model Context Protocol (MCP) server that provides read access to Dropbox files with advanced search and content extraction capabilities.
Features
File Listing: Browse files and folders in your Dropbox
File Reading: Read content from various file types (PDF, DOCX, TXT, code files)
Search: Search for files by name across your Dropbox
Content Search: Search for specific text within files
File Info: Get detailed metadata about files
Smart Text Extraction: Automatically extracts text from PDFs and DOCX files
Supported File Types
PDF - Text extraction with PyPDF2
DOCX/DOC - Document text extraction
Text files - TXT, MD, PY, JS, HTML, CSS, JSON, CSV
Installation
Prerequisites
Python 3.10 or higher
A Dropbox account and access token
Get a Dropbox Access Token
Go to the Dropbox App Console
Click "Create app"
Choose "Scoped access" and "Full Dropbox" access
Name your app
Go to the "Permissions" tab and enable:
files.metadata.readfiles.content.read
Go to the "Settings" tab and generate an access token
Install Dependencies
Or install manually:
Configuration
Set your Dropbox access token as an environment variable:
For Claude Desktop
Add to your claude_desktop_config.json:
For Smithery
The server will automatically use the DROPBOX_ACCESS_TOKEN environment variable when deployed.
Available Tools
list_files
List files and folders in a Dropbox directory.
Parameters:
folder_path(optional): Path to folder (empty for root)max_files(optional): Maximum items to return (default: 20)
search_files
Search for files by name.
Parameters:
query: Search queryfile_types(optional): File types to search ("all", "pdf", "docx", "txt", or comma-separated)max_results(optional): Maximum results (default: 10)
read_file
Read the full content of a file.
Parameters:
file_path: Full path to the filemax_length(optional): Maximum characters to return (default: 5000, 0 for unlimited)
get_file_info
Get detailed metadata about a file.
Parameters:
file_path: Full path to the file
search_file_content
Search for text within specific files.
Parameters:
file_paths: List of file paths to searchquery: Text to search forcontext_chars(optional): Characters of context around matches (default: 100)
Usage Examples
List files in root directory
Search for PDF files
Read a specific file
Search within files
Development
Running Locally
Testing
Make sure your DROPBOX_ACCESS_TOKEN is set, then run the server and test with an MCP client.
Security Notes
Keep your Dropbox access token secure and never commit it to version control
Use environment variables or secure secret management
The server only provides read access to Dropbox files
Consider using app-scoped tokens with minimal permissions
License
MIT License - feel free to use and modify as needed.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Support
For issues and questions, please open an issue on GitHub.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Provides read access to Dropbox files with advanced search and content extraction capabilities. Supports browsing, reading, and searching within various file types including PDFs, DOCX, and text files.