Dropbox Integration

Pro v1.0.0

Manage files, folders, and sharing in your Dropbox account through the official Python SDK

Requires Claude Code CLI

This skill integrates with Dropbox through Claude Code. Install Claude Code and add this skill to use it.

Available Actions

List Files

List files and folders in a Dropbox directory

Parameters

Name Type Required Description
path string Optional Directory path (empty for root, or /path/to/folder)

Returns

object JSON with folder path and array of entries

Try saying...

  • "List files in my Dropbox Documents folder"
  • "Show me what's in the root of my Dropbox"
  • "What files are in /Projects"

Upload File

Upload a file from local system to Dropbox

Parameters

Name Type Required Description
local_path string Required Path to local file to upload
dropbox_path string Required Destination path in Dropbox

Returns

object Upload confirmation with file metadata

Try saying...

  • "Upload my local file to Dropbox"
  • "Put this document in my Dropbox Documents folder"
  • "Backup this file to Dropbox"

Download File

Download a file from Dropbox to local system

Parameters

Name Type Required Description
dropbox_path string Required Path to file in Dropbox
local_path string Required Where to save the file locally

Returns

object Download confirmation with file metadata

Try saying...

  • "Download this file from Dropbox"
  • "Get my presentation from Dropbox"
  • "Retrieve the latest version of this document"

Search Files

Search for files and folders across entire Dropbox

Parameters

Name Type Required Description
query string Required Search query

Returns

object Search results with matching files and folders

Try saying...

  • "Search my Dropbox for files about the project"
  • "Find all PDFs containing 'invoice'"
  • "Look for files with 'budget' in the name"

Share File

Create a shareable link for a file or folder

Parameters

Name Type Required Description
path string Required Path to file or folder to share

Returns

object Shareable URL for the file or folder

Try saying...

  • "Create a share link for this folder"
  • "Generate a Dropbox link I can send to my colleague"
  • "Share this file from Dropbox"

Get File Info

Get detailed metadata about a file or folder

Parameters

Name Type Required Description
path string Required Path to file or folder

Returns

object File metadata including name, size, modification date

Try saying...

  • "Get information about this file"
  • "Show me the metadata for this document"
  • "When was this file last modified?"

Delete File

Delete a file or folder from Dropbox

Parameters

Name Type Required Description
path string Required Path to file or folder to delete

Returns

object Deletion confirmation

Try saying...

  • "Delete this old file from Dropbox"
  • "Remove the backup folder"
  • "Clean up these temporary files"

Getting Started

API Key Easy Setup
  1. 1 Go to Dropbox App Console (https://www.dropbox.com/developers/apps)
  2. 2 Click 'Create app' and select 'Scoped access' and 'Full Dropbox'
  3. 3 Enable required scopes in the Permissions tab: files.metadata.read, files.metadata.write, files.content.read, files.content.write, sharing.write
  4. 4 Go to Settings tab and generate an access token under OAuth 2 section
  5. 5 Add to shell config: echo 'export DROPBOX_ACCESS_TOKEN="YOUR_TOKEN"' >> ~/.zshrc
  6. 6 Restart terminal or run: source ~/.zshrc

Verify Setup

python scripts/client.py list

Success: JSON output with your Dropbox root folder contents

View full setup guide

Security & Access

Access Scope

Full access to your Dropbox account - can read, write, delete files and create shared links

  • Keep your access token secure and never commit it to version control
  • Token grants complete access to your Dropbox account
  • Revoke access from App Console if token is compromised
  • For production use with multiple users, implement OAuth 2.0 instead of generated tokens

Limitations

  • Generated access tokens work only for your own account
  • For multi-user apps, implement full OAuth 2.0 flow
  • Simple upload limited to 150MB files (larger files use chunked upload)
  • SDK v12.0.2+ required for 2026 API server certificate compatibility

Get This Skill

Requires Pro subscription ($9/month)

Quick Reference

Type
PYTHON_SDK
Auth
API Key
Setup
Easy Setup
Tools Required
Bash
Python Dependencies
dropbox>=12.0.2

Documentation

Have Feedback?

Help us improve this skill by sharing your ideas and suggestions.

Request Improvements