Skip to main content

Overview

OneCLI connects AI agents to Dropbox through OAuth. Agents can browse files and folders, download and upload content, and manage sharing. The gateway injects OAuth credentials into requests to the Dropbox API automatically.

What you will set up

  • A Dropbox connection through OAuth, with read access by default and optional write access
  • Automatic token injection on requests to the Dropbox API
  • Per-agent, per-tool access to files and sharing

Setup

1

Open the app

Open the OneCLI dashboard and navigate to Settings > Apps > Dropbox.
2

Authorize

Click Connect Dropbox. You’ll be redirected to Dropbox to authorize OneCLI. Review the requested permissions and click Allow.
OneCLI connect window for Dropbox on Cloud, showing the Connect to Dropbox button.

The Dropbox connect window on OneCLI Cloud.

OneCLI requests read access to account info, file metadata, and file content by default. Write access for uploading, organizing, and sharing is optional.
3

Verify

After authorization, you’ll be redirected back to the dashboard. The connection will show as Connected with your Dropbox email.

What agents can do

Use cases

  • Document processing agents that read files from Dropbox and extract information
  • Backup agents that upload generated reports or exports
  • File organization agents that sort and rename files based on content
  • Collaboration agents that share files and manage folder permissions

Self-hosted: use your own Dropbox app

Skip this section on OneCLI Cloud. It’s only for self-hosted OneCLI without DROPBOX_CLIENT_ID and DROPBOX_CLIENT_SECRET set, or if you want your own company name on Dropbox’s consent screen.

1. Create the Dropbox app

Go to the Dropbox App Console and select Create app. Choose Scoped access and Full Dropbox, name it (for example OneCLI-yourcompany), and create it.
Open Permissions, tick these, and select Submit:account_info.read, files.metadata.read, files.content.read, files.content.write, sharing.read, sharing.write
Dropbox app named OneCLI on the Permissions tab, with account_info.read, files.content.read, and files.content.write ticked.

The Permissions tab of your Dropbox app, with the file scopes ticked.

In OneCLI, open Settings > Apps > Dropbox > Custom credentials and copy the Redirect URI. In Dropbox, open Settings, paste it into OAuth 2 > Redirect URIs, and select Add.
OneCLI Custom credentials card for Dropbox with the setup guide link, the Redirect URI and its copy button, and the client ID and secret fields.

Copy the Redirect URI from Custom credentials in OneCLI.

Dropbox app Settings, OAuth 2 section, with https://onecli.example.com/v1/apps/dropbox/callback under Redirect URIs.

The OAuth 2 section of your Dropbox app's Settings tab, with the OneCLI Redirect URI.

On the Dropbox Settings tab, copy the App key and App secret. Paste both into Settings > Apps > Dropbox > Custom credentials, select Save credentials, then Connect and allow access in Dropbox.

Controlling access

Access is per agent: grant the connection to each agent that needs it, choosing per tool what runs freely, what needs human approval, and what stays blocked — a read-only agent is a single grant. Organization rules add guardrails on top, like rate limits and blanket blocks. Everything is checked before credential injection, so a blocked request never reaches Dropbox.

FAQ

Yes. OneCLI requests read access by default, and write access is optional. You can also grant only the read tools to a specific agent.
No. The token stays in OneCLI, and the gateway adds it to Dropbox API requests at the proxy. See How it works.
Yes. Set sharing and delete tools to need approval when you grant the connection, or add organization rules.
Open Settings > Apps > Dropbox and connect again. Agents with access use the new connection automatically.