stackgate.ai
All integrations

Dropbox

Connect Dropbox to Claude, ChatGPT or Cursor via MCP. OAuth, file search and download, small uploads, and shared links through a governed private gateway.

OAuth 12 tools

Example questions

Try asking your AI client

  • List the files in my Dropbox root.

  • Search Dropbox for invoices from this year.

  • Download the brief in /Shared into temp storage so I can read it.

  • Write a short note and upload it to /Notes/meeting.txt.

  • Create a view link for /Shared/brief.pdf.

Overview

Connect Dropbox to give AI clients access to the files in your Dropbox account. This is the hosted Dropbox MCP integration for Claude, ChatGPT, Cursor, and other MCP clients.

Common use cases

  • File search - list a folder or search by name, then open metadata before downloading.
  • Handoff - download a file into temp storage so another integration can read it.
  • Light edits - create folders, upload small text files, move, copy, or delete after you confirm.
  • Sharing - list or create a view link for a file or folder.

Prerequisites

  • A Dropbox account
  • A stackgate.ai account

Getting credentials

  1. Sign in to stackgate.ai.
  2. Go to Integrations and open Dropbox.
  3. Click Activate, choose tool access (standard or scoped), then Connect Dropbox.
  4. Approve the Dropbox prompt. stackgate.ai stores your tokens and refreshes them when they expire.

The hub Dropbox app uses Full Dropbox access. If your organization uses an App folder app instead, AI can only see files under /Apps/{app name}.

Using with AI clients

  • Dedicated endpoint: POST /mcp/dropbox with a Sanctum bearer token
  • Private gateway: one config for all integrations - use dropbox__* namespaced tools

See Documentation for HTTP authentication and private gateway setup.

Troubleshooting

  • 422 integration not configured - finish Connect Dropbox in My Integrations.
  • Authentication failed - disconnect and connect Dropbox again so a fresh refresh token is stored.
  • path/not_found - list the root with an empty path (""). Other paths start with /.
  • Only the app folder is visible - the Dropbox app is limited to App folder access. Full Dropbox access is required to see the rest of the account.
  • 429 rate limit - wait for the Retry-After time, then try again. Avoid parallel writes to the same folder.
  • Upload too large - upload_file accepts files up to 10 MB.
  • Missing write tools - turn on Write access, or include write tools when you choose scoped tool access.

Available tools

  • list_folder

    List files and folders in a Dropbox folder. Use an empty path for the root. Continue with list_folder_continue when has_more is true.

  • list_folder_continue

    Fetch the next page of a list_folder result using its cursor.

  • search_files

    Search Dropbox files and folders by name or content snippet.

  • get_metadata

    Get metadata for a Dropbox file or folder by path.

  • download_file

    Download a Dropbox file. Default mode returns inline bytes for files under 10 MB or a resource link for larger files. Use mode temp-storage to store a copy and receive a file_id.

  • create_folder

    Create a folder in Dropbox.

  • upload_file

    Upload a small file (up to 10 MB) to Dropbox from UTF-8 text or a temp storage file_id.

  • move_path

    Move or rename a Dropbox file or folder.

  • copy_path

    Copy a Dropbox file or folder to a new path.

  • delete_path

    Delete a Dropbox file or folder. Confirm with the user before calling this tool.

  • list_shared_links

    List shared links the connected account created. Optionally limit the list to one path.

  • create_shared_link

    Create a view-only shared link for a Dropbox file or folder. If a link already exists, the error includes the existing URL.

MCP endpoint: https://stackgate.ai/mcp/dropbox (HTTP) or via the private gateway.

Create account Documentation