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.

​
Setup

1

Go to Connections

Open the OneCLI dashboard and navigate to Connections > 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 Connections > 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 Connections > Dropbox > Custom credentials, select Save & 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.