ai.smithery/cindyloo-dropbox-mcp-server
Search, browse, and read your Dropbox files. Find documents by name or content, list folders, and…
Open source Repository Open in the app JSON README (API)
About
Search, browse, and read your Dropbox files. Find documents by name or content, list folders, and…
Details
- Kind
- MCP servers
- Topic
- Files & documents
- Publisher
- ai.smithery
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.15.0
- Open pull requests
- 1
- Last push
- 2025-09-30T02:01:40Z
- Repository state
- ativo
- Language
- Python
- Added
- 2026-08-29 03:00:39
- Updated
- 2026-08-29 03:00:39
- Origin id
ai.smithery/cindyloo-dropbox-mcp-server
README
# 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
1. Go to the [Dropbox App Console](https://www.dropbox.com/developers/apps)
2. Click "Create app"
3. Choose "Scoped access" and "Full Dropbox" access
4. Name your app
5. Go to the "Permissions" tab and enable:
- `files.metadata.read`
- `files.content.read`
6. Go to the "Settings" tab and generate an access token
### Install Dependencies
```bash
pip install -e .
```
Or install manually:
```bash
pip install mcp dropbox pydantic PyPDF2 python-docx
```
## Configuration
Set your Dropbox access token as an environment variable:
```bash
export DROPBOX_ACCESS_TOKEN="your_access_token_here"
```
### For Claude Desktop
Add to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"dropbox": {
"command": "python",
"args": ["/path/to/your/dropbox_server.py"],
"env": {
"DROPBOX_ACCESS_TOKEN": "your_access_token_here"
}
}
}
}
```
### 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 query
- `file_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 file
- `max_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 search
- `query`: Text to search for
- `context_chars` (optional): Characters of context around matches (default: 100)
## Usage Examples
### List files in root directory
```python
list_files()
```
### Search for PDF files
```python
search_files(query="invoice", file_types="pdf", max_results=5)
```
### Read a specific file
```python
read_file(file_path="/documents/report.pdf")
```
### Search within files
```python
search_file_content(
file_paths=["/documents/file1.txt", "/documents/file2.pdf"],
query="important keyword"
)
```
## Development
### Running Locally
```bash
python dropbox_server.py
```
### 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.