@kentcdodds/dropbox

@kentcdodds/dropbox

Intent

Provide reusable, account-agnostic Dropbox helpers for Kody agents through the standard saved dropbox OAuth integration. Cover common account, metadata, search, transfer (small and large uploads), deletion, and sharing workflows — including direct content URLs — while retaining a generic escape hatch for the rest of the Dropbox API. Agents should use these MCP exports instead of the Dropbox website UI.

What it does

• Inspect the connected Dropbox account or storage usage
• List folders, read metadata, and search for files
• Download or upload file content (small single-shot or large upload sessions)
• Save a remote URL into Dropbox when chat cannot carry large base64
• Delete files or create shared links with explicit confirmation
• Ensure a shared link and return a curl-friendly direct content URL
• Call less-common Dropbox RPC and content endpoints through ./request

Mutating helpers require confirm: true and support dryRun: true. Paths begin with /. Kody-writable files usually live under /Apps/Kody/… — list the root first. Agents: copy-paste upload and share recipes live in AGENTS.md.

Prerequisites / setup

1. Connect a Dropbox OAuth integration named dropbox at https://kody.codes/connect/oauth?provider=dropbox.
2. Grant the scopes your workflows need. Common scopes: account_info.read, files.metadata.read, files.metadata.write, files.content.read, files.content.write, sharing.read, sharing.write.
3. Agents: see AGENTS.md for import paths, smoke, dryRun, and the Upload a file (small vs large) playbook.

Done when

• The dropbox OAuth integration is connected
• Smoke test returns { ok: true } without account PII
• Mutations refuse without confirm: true; dryRun: true never calls Dropbox
• Large uploads use ./upload-large (or ./upload auto-delegate) with bytesBase64 in execute params, not inlined in code