Dropbox Server
Overview
The Dropbox server provides essential file management capabilities for your Dropbox account. Built by Dropbox, this server enables AI assistants to search files, upload content, and access your cloud storage directly.Getting Started
Authenticate with Dropbox
Connect your Dropbox account using OAuth to access your files and folders.
What You Can Do
File Search
Search for files across your entire Dropbox or within specific folders
File Upload
Upload new files directly to your Dropbox with base64 encoded content
Folder Navigation
Search within specific folder paths for targeted file discovery
Content Management
Organize and access your cloud storage through AI assistant interactions
Use Cases
Document Management
Document Management
- File Discovery: Find documents, spreadsheets, and presentations across your Dropbox
- Content Search: Search file names and metadata to locate specific resources
- Organization: Navigate folder structures and understand file organization
- Quick Access: Retrieve files without manually browsing through folders
Content Creation & Storage
Content Creation & Storage
- Document Upload: Create and upload new files directly from AI conversations
- Content Backup: Store generated content, reports, and data files
- Collaborative Storage: Upload files for team access and sharing
- Automated Archiving: Store conversation outputs and generated materials
Research & Analysis
Research & Analysis
- Data File Access: Find and analyze CSV files, databases, and datasets
- Report Storage: Access existing reports and analysis documents
- Reference Material: Locate research papers, documentation, and resources
- Version Control: Find different versions of documents and compare changes
Project Management
Project Management
- Asset Discovery: Find project files, images, and resources
- Documentation Access: Locate project documentation and specifications
- File Sharing Preparation: Search for files that need to be shared or distributed
- Archive Management: Access historical project files and documentation
Available Tools (13)
list_files
list_files
List files in a folder with optional path parameter (default: root)
upload_file
upload_file
Upload a file with path and base64 encoded content
download_file
download_file
Download a file to local disk and return the file path. Files are saved to the “downloads” directory
safe_delete_item
safe_delete_item
Safely delete a file or folder with recycle bin support, confirmation, and audit logging
delete_item
delete_item
Legacy delete operation (deprecated, use safe_delete_item instead)
create_folder
create_folder
Create a new folder at the specified path
copy_item
copy_item
Copy a file or folder to a new location
move_item
move_item
Move or rename a file or folder
get_file_metadata
get_file_metadata
Get metadata for a file or folder
search_file_db
search_file_db
Advanced search for files and folders with filtering capabilities including file extensions, categories, date ranges, content matching, and sorting options
get_sharing_link
get_sharing_link
Create a shared link for a file or folder
get_account_info
get_account_info
Get information about the connected Dropbox account
get_file_content
get_file_content
Get the content of a file from Dropbox
Configuration Requirements
Authentication Setup
The Dropbox server uses OAuth2 authentication with specific file access scopes:OAuth Scopes
OAuth Scopes
Required Permissions:
- files.metadata.read: Read file and folder metadata (for search operations)
- files.content.read: Read file content (for comprehensive access)
- files.content.write: Write and upload files (for upload operations)
searchandsearch_file_db: files.metadata.readupload_file: files.content.read + files.content.write
Account Requirements
Account Requirements
- Dropbox Account: Personal or business Dropbox account
- Storage Space: Sufficient storage for upload operations
- API Access: Dropbox API access enabled (typically available for all accounts)
Best Practices
File Search Strategies
- Start Broad: Use general terms first, then narrow down with specific keywords
- Use Extensions: Include file extensions (.pdf, .xlsx, .png) to filter by type
- Folder-Specific: Use
search_file_dbwhen you know the approximate location - Pagination: Use max_results parameter to control search result volume
File Upload Guidelines
- Path Planning: Use clear, descriptive folder structures (e.g., “/projects/2024/reports/”)
- File Naming: Use descriptive names with dates or version numbers
- Encoding Verification: Ensure proper base64 encoding before upload
- Size Considerations: Be aware of file size limits and account storage capacity
Organization & Management
- Consistent Naming: Use consistent file naming conventions for better searchability
- Folder Structure: Maintain organized folder hierarchies for efficient searching
- Regular Cleanup: Periodically search for and organize files to maintain structure
- Backup Strategy: Use uploads to create backups of important generated content
Integration Workflows
- Document Generation: Generate content and immediately upload to Dropbox for storage
- Research Workflows: Search for existing files before creating new documents
- Collaboration: Upload files to shared folders for team access
- Archive Management: Use search to maintain and organize historical files
Guardrails
In addition to the 14 universal guardrails, this server has 55 server-specific guardrails across 9 operations.| Guardrail | Operation | Timing | Description |
|---|---|---|---|
| Copy Item - Allowed Source Folders Only | copy_item | Request | Restricts copying items from whitelisted source directories only |
| Copy Item - Allowed Destination Folders Only | copy_item | Request | Restricts copying items to whitelisted destination directories only |
| Create Folder - Allowed Parent Paths Only | create_folder | Request | Restricts folder creation to whitelisted parent directories |
| Block Deprecated Delete Item Operation | delete_item | Request | Blocks the deprecated delete_item operation (use safe_delete_item instead) |
| Download File - Allowed Folders Only | download_file | Response | Blocks downloading files from non-allowed directories |
| Download File - Block Malicious Formats | download_file | Response | Blocks downloading files with potentially malicious extensions |
| Download File - Email Domain Filter | download_file | Response | Blocks downloading files from paths with non-approved email domains |
| Get File Content - Allowed Folders Only | get_file_content | Response | Blocks access to file content from non-allowed directories |
| Get File Content - Block Malicious Formats | get_file_content | Response | Blocks access to files with potentially malicious extensions |
| Get File Content - Email Domain Filter | get_file_content | Response | Blocks access to file content from paths with non-approved email domains |
| Get File Metadata - Allowed Folders Only | get_file_metadata | Response | Blocks access to file metadata from non-allowed directories |
| Get File Metadata - Email Domain Filter | get_file_metadata | Response | Blocks access to file metadata from paths with non-approved email domains |
| List Files - Allowed Folders Only | list_files | Response | Redacts files/folders from non-allowed directories in list results |
| List Files - Block Malicious Formats | list_files | Response | Redacts files with potentially malicious extensions |
| List Files - Email Domain Filter | list_files | Response | Redacts files from paths containing non-approved email domains |
| Move Item - Allowed Source Folders Only | move_item | Request | Restricts moving items from whitelisted source directories only |
| Move Item - Allowed Destination Folders Only | move_item | Request | Restricts moving items to whitelisted destination directories only |
| Safe Delete Item - Allowed Folders Only | safe_delete_item | Request | Restricts deletions to whitelisted directories only |
| Block Regex Search Patterns | search | Request | Prevents searches containing regex patterns or wildcards |
| Block Sensitive Search Terms | search | Request | Prevents searching for passwords, keys, credentials and other sensitive terms |
| Filter Large Files | search | Response | Hides files above a certain size threshold |
| Filter Sensitive Extensions | search | Response | Redacts files with sensitive extensions like .key, .pem, .env |
| Filter Sensitive Folders | search | Response | Filters out files from specific sensitive folders in search results |
| Redact Sensitive Paths | search | Response | Redacts file paths containing sensitive patterns |
| Search Path Restrictions | search | Request | Limits search to specific folder paths or prefixes |
| Block Sensitive File Patterns | search_file_db | Request | Prevents searches for sensitive file patterns |
| Block System Folder Search | search_file_db | Request | Prevents searches in system or hidden folders |
| Filter Shared Files | search_file_db | Response | Filters out shared or collaborative files from results |
| Filter Unauthorized Folders | search_file_db | Response | Filters results from unauthorized folders |
| Maximum Results Limit | search_file_db | Request | Limits maximum results to prevent data exfiltration |
| Minimum Query Specificity | search_file_db | Request | Requires minimum query length to prevent broad searches |
| Redact File Previews | search_file_db | Response | Redacts file preview content from search results |
| Search DB Path Restrictions | search_file_db | Request | Restricts folder search to allowed directories |
| Search File DB - Allowed Folders Only | search_file_db | Response | Redacts search results from non-allowed directories |
| Search File DB - Block Malicious Formats | search_file_db | Response | Redacts search results with potentially malicious file extensions |
| Search File DB - Email Domain Filter | search_file_db | Response | Redacts search results from paths with non-approved email domains |
| Allowed File Types | upload_file | Request | Restricts uploads to specific file types only |
| Block Root Directory Upload | upload_file | Request | Prevents uploading files directly to the root directory |
| Block Sensitive Upload Extensions | upload_file | Request | Prevents uploads with sensitive file extensions |
| File Naming Convention | upload_file | Request | Enforces specific file naming patterns for uploads |
| Prevent File Overwrite | upload_file | Request | Blocks uploads that would overwrite existing files |
| Upload File - Allowed Folders Only | upload_file | Request | Restricts file uploads to whitelisted directories only |
| Upload File - Block Malicious Formats | upload_file | Request | Blocks uploading files with potentially malicious extensions |
| Upload Path Restrictions | upload_file | Request | Restricts file uploads to specific allowed directories |
| Upload Size Limit | upload_file | Request | Limits the size of uploaded files |