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 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 setup

For self-hosted deployments, configure your own Dropbox OAuth app:
  1. Create an app in the Dropbox App Console
  2. Set the environment variables DROPBOX_CLIENT_ID and DROPBOX_CLIENT_SECRET

​
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.