dropboxManage Dropbox files securely with OAuth 2.0 PKCE via CLI or MCP server, supporting upload, download, search, delete, and account info operations.
Install via ClawdBot CLI:
clawdbot install RyanLisse/dropboxManage Dropbox files via MCP server and CLI. Swift-native implementation using SwiftyDropbox SDK with OAuth 2.0 PKCE and secure Keychain token storage.
# Clone and build Dropbook
git clone https://github.com/RyanLisse/Dropbook.git
cd Dropbook
make buildUse the interactive OAuth flow with secure Keychain storage:
export DROPBOX_APP_KEY="your_dropbox_app_key"
export DROPBOX_APP_SECRET="your_dropbox_app_secret"
make login
# or: swift run dropbook loginThis will:
~/.dropbook/auth.json if Keychain unavailableSecurity Features (RFC 9700 compliant):
kSecAttrAccessibleWhenUnlockedexport DROPBOX_APP_KEY="your_dropbox_app_key"
export DROPBOX_APP_SECRET="your_dropbox_app_secret"
export DROPBOX_ACCESS_TOKEN="your_dropbox_access_token"Note: Manual tokens don't support automatic refreshing. Use OAuth login for production use.
Clear stored tokens from both Keychain and file storage:
make logout
# or: swift run dropbook logoutStart the MCP server:
make mcp
# or: ./.build/debug/dropbook mcp| Tool | Description |
|------|-------------|
| list_directory | List files and folders in a Dropbox directory |
| search | Search for files by name or content |
| upload | Upload a file to Dropbox |
| download | Download a file from Dropbox |
| delete | Delete a file or folder (moves to trash) |
| get_account_info | Get account name and email |
| read_file | Read contents of a text file |
List files and folders in a Dropbox directory.
Parameters:
path (string, optional): Directory path. Default: "/"Response:
{
"files": [
{"type": "file", "name": "doc.pdf", "path": "/Docs/doc.pdf", "size": 1024},
{"type": "folder", "name": "Projects", "path": "/Projects"}
]
}Search for files by name or content.
Parameters:
query (string, required): Search termpath (string, optional): Path to search within. Default: "/"Response:
{
"count": 2,
"results": [
{"matchType": "filename", "metadata": {"name": "report.pdf", "path": "/Docs/report.pdf"}}
]
}Upload a file to Dropbox.
Parameters:
localPath (string, required): Absolute path to local fileremotePath (string, required): Destination in Dropboxoverwrite (boolean, optional): Replace if exists. Default: falseResponse:
{
"uploaded": true,
"name": "file.txt",
"path": "/Uploads/file.txt",
"size": 5000
}Download a file from Dropbox.
Parameters:
remotePath (string, required): File path in DropboxlocalPath (string, required): Local destination pathResponse:
{
"downloaded": true,
"to": "/tmp/report.pdf"
}Delete a file or folder from Dropbox (moves to trash).
Parameters:
path (string, required): Path to delete in DropboxResponse:
{
"deleted": true,
"path": "/Docs/old-file.pdf"
}Get Dropbox account information.
Parameters: None
Response:
{
"name": "Ryan Lisse",
"email": "user@example.com"
}Read and return the contents of a text file from Dropbox.
Parameters:
path (string, required): Path to file in DropboxResponse:
Returns the file contents as text. Only works with UTF-8 encoded text files.
# Authentication
make login # OAuth login with Keychain storage
make logout # Clear stored tokens
# File operations
make list # List root directory
swift run dropbook list /path
# Search files
swift run dropbook search "query" [path]
# Upload file
swift run dropbook upload /local/path /remote/path [--overwrite]
# Download file
swift run dropbook download /remote/path /local/path
# Start MCP server
make mcpThe project includes a .mcp.json file that configures the MCP server:
{
"mcpServers": {
"dropbox": {
"command": "/path/to/Dropbook/.build/debug/dropbook",
"args": ["mcp"],
"env": {
"DROPBOX_APP_KEY": "${DROPBOX_APP_KEY}",
"DROPBOX_APP_SECRET": "${DROPBOX_APP_SECRET}"
}
}
}
}Enable project MCP servers in Claude Code settings.json:
{
"enableAllProjectMcpServers": true
}{
"mcpServers": {
"dropbox": {
"command": "/path/to/dropbook/.build/debug/dropbook",
"args": ["mcp"],
"env": {
"DROPBOX_APP_KEY": "${DROPBOX_APP_KEY}",
"DROPBOX_APP_SECRET": "${DROPBOX_APP_SECRET}"
}
}
}
}| Error | Cause | Solution |
|-------|-------|----------|
| notConfigured | Missing env vars | Set DROPBOX_APP_KEY, DROPBOX_APP_SECRET |
| invalidArguments | Missing required params | Check tool parameters |
| notFound | Path doesn't exist | Use list_directory to verify paths |
| itemNotFound | No token in Keychain | Run make login to authenticate |
Dropbook/
āāā Sources/
ā āāā DropbookCore/ # Business logic (actor-based)
ā ā āāā Auth/ # Keychain & file token storage
ā ā āāā Config/ # Configuration management
ā ā āāā Models/ # Domain models
ā ā āāā Services/ # DropboxService actor
ā āāā DropbookCLI/ # CLI adapter
ā ā āāā Commands/ # Login, logout, file commands
ā āāā DropbookMCP/ # MCP server
āāā dropbox-skill/ # Skill documentation
āāā Makefile # Build automation
āāā .mcp.json # MCP server configuration
āāā Package.swiftFor large-scale operations like backups, syncing, or bulk transfers, use rclone - a powerful cloud sync tool with native Dropbox support.
brew install rclone# Interactive setup (opens browser for OAuth)
rclone authorize dropbox
# Save the token output to config
mkdir -p ~/.config/rclone
cat > ~/.config/rclone/rclone.conf << 'EOF'
[dropbox]
type = dropbox
token = {"access_token":"...paste token here..."}
EOF# Full backup with progress
rclone copy dropbox: /Volumes/TimeCapsule/Dropbox-Backup \
--progress \
--transfers 4 \
--checkers 8 \
--retries 10 \
--log-file /tmp/dropbox-backup.log
# Sync (mirror - deletes files not in source)
rclone sync dropbox: /Volumes/Backup/Dropbox --progress
# Check what would be copied (dry run)
rclone copy dropbox: /Volumes/Backup --dry-run# List remote contents
rclone lsd dropbox: # List directories
rclone ls dropbox: # List all files
rclone size dropbox: # Calculate total size
# Copy operations
rclone copy dropbox:folder /local/path # Download folder
rclone copy /local/path dropbox:folder # Upload folder
# Sync (bidirectional)
rclone bisync dropbox: /local/path --resync
# Mount as filesystem (macOS - requires macFUSE)
rclone mount dropbox: /mnt/dropbox --vfs-cache-mode full| Flag | Description |
|------|-------------|
| --progress | Show real-time transfer progress |
| --transfers 4 | Number of parallel transfers |
| --checkers 8 | Number of parallel checkers |
| --retries 10 | Retry failed operations |
| --low-level-retries 20 | Retry low-level errors |
| --log-file path | Write logs to file |
| --dry-run | Show what would be done |
| --checksum | Verify with checksums |
Dropbox has strict API rate limits. If you see too_many_requests errors:
# Use bandwidth limiting
rclone copy dropbox: /backup --bwlimit 1M
# Or add delays between operations
rclone copy dropbox: /backup --tpslimit 2rclone handles rate limits automatically with exponential backoff.
list_directory before operationsbrew install rclone)Generated Mar 1, 2026
A freelance writer or designer uses the skill to manage client files, upload drafts, and share final deliverables securely. They can quickly search for specific documents across projects and ensure version control by listing directories and uploading with overwrite options.
A small business owner utilizes the skill to organize financial records, contracts, and reports in Dropbox. They can automate file backups by uploading from local systems, retrieve account info for audits, and delete outdated files to free up space.
A distributed team employs the skill to streamline file sharing and access control. Members can list shared directories, search for project files, and download updates, enhancing productivity without manual Dropbox web interface navigation.
A researcher uses the skill to manage datasets, papers, and notes stored in Dropbox. They can upload raw data, search for specific studies by content, and read text files directly for analysis, supporting efficient data organization.
An IT professional integrates the skill into workflows to handle file operations for users. They can automate uploads of logs or downloads of software, delete temporary files, and verify paths with list_directory to troubleshoot storage issues.
Offer a basic version of the skill for free to attract users, with premium features like advanced search or bulk operations available via subscription. Revenue is generated through monthly or annual plans targeting small teams and enterprises.
Sell customized licenses to large organizations needing enhanced security and support. This includes dedicated MCP server configurations, priority error handling, and training, with revenue from one-time fees or annual contracts.
Provide services to integrate the skill into existing business systems, such as CRM or project management tools. Revenue comes from hourly rates or fixed project fees for setup, automation, and ongoing maintenance support.
š¬ Integration Tip
Ensure DROPBOX_APP_KEY and DROPBOX_APP_SECRET environment variables are set before starting the MCP server to avoid authentication errors; use the OAuth login method for automatic token refreshing in production environments.
Use the mcporter CLI to list, configure, auth, and call MCP servers/tools directly (HTTP or stdio), including ad-hoc servers, config edits, and CLI/type generation.
Connect to 100+ APIs (Google Workspace, Microsoft 365, GitHub, Notion, Slack, Airtable, HubSpot, etc.) with managed OAuth. Use this skill when users want to...
Build, debug, and deploy websites using HTML, CSS, JavaScript, and modern frameworks following production best practices.
YouTube Data API integration with managed OAuth. Search videos, manage playlists, access channel data, and interact with comments. Use this skill when users want to interact with YouTube. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Scaffold, test, document, and debug REST and GraphQL APIs. Use when the user needs to create API endpoints, write integration tests, generate OpenAPI specs, test with curl, mock APIs, or troubleshoot HTTP issues.
Search for jobs across LinkedIn, Indeed, Glassdoor, ZipRecruiter, Google Jobs, Bayt, Naukri, and BDJobs using the JobSpy MCP server.