Dropbox MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Set up the connector

   Register your Dropbox MCP credentials with Scalekit so it handles the token lifecycle. You do this once per environment.

   Dashboard setup steps

   Create a Dropbox OAuth app to get a client ID and secret, then register your Scalekit redirect URI so Dropbox can redirect users back after authorization.

   1. Create a Dropbox developer app

      • Go to dropbox.com/developers and sign in.
      • Click Create apps.

      

   2. Configure the app

      On the app creation form:

      • Choose an API: Select Scoped access.
      • Choose the type of access: Select Full Dropbox — Access to all files and folders in a user’s Dropbox.
      • Name your app: Enter a name (e.g. Agent Auth).
      • Click Create app.

      

   3. Copy your credentials and add the redirect URI

      On your app’s settings page:

      • Copy the App key (this is your client ID) and App secret (click Show to reveal).
      • Under OAuth 2 → Redirect URIs, add your Scalekit redirect URI and click Add.

      

   4. Create a connection in Scalekit

      • In the Scalekit dashboard, go to AgentKit → Connections → Create Connection.
      • Search for Dropbox MCP and click Create.
      • Enter the App key as the client ID and App secret as the client secret.
      • Note the Connection name — use this as connection_name in your code (e.g., dropboxmcp).

4. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'dropboxmcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Dropbox MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'dropboxmcp_check_job_status',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "dropboxmcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Dropbox MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="dropboxmcp_check_job_status",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• I who am — Retrieve the current Dropbox account profile information
• Search records — Search for files and folders in Dropbox by query with optional filters
• Move records — Move one or more files or folders to a new location in Dropbox
• List shared links, folder, file requests — List shared links for the account or a specific path with pagination
• Get usage and quota, shared link metadata, file request — Retrieve the current storage usage and quota for the Dropbox account
• Link download — Get temporary download URLs for one or more files

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

dropboxmcp_check_job_status#Check the status of an async Dropbox operation by its job ID.2 params▾

Check the status of an async Dropbox operation by its job ID.

NameTypeRequiredDescription

operation_idstringoptionalThe async job ID returned from a previous Dropbox operation.

wait_msintegeroptionalMilliseconds to wait for the job to complete before returning.

dropboxmcp_copy#Copy one or more files or folders to a new location in Dropbox.2 params▾

Copy one or more files or folders to a new location in Dropbox.

NameTypeRequiredDescription

autorenamebooleanoptionalIf true, renames the destination if a conflict exists.

entriesarrayoptionalList of file or folder paths to operate on.

dropboxmcp_create_file#Create a new file at the specified path with the given content.2 params▾

Create a new file at the specified path with the given content.

NameTypeRequiredDescription

contentstringrequiredThe text content to write to the new file.

pathstringrequiredThe Dropbox path to the file or folder (e.g. /Documents/report.pdf).

dropboxmcp_create_file_request#Create a file request so others can upload files to your Dropbox.7 params▾

Create a file request so others can upload files to your Dropbox.

NameTypeRequiredDescription

closedbooleanoptionalIf true, the file request is closed and no longer accepts uploads.

deadlinestringoptionalThe deadline for the file request in ISO 8601 format.

deadline_allow_late_uploadsstringoptionalNo description.

descriptionstringoptionalAn optional description shown to uploaders.

destinationstringoptionalThe Dropbox folder path where uploaded files will be saved.

titlestringoptionalThe title of the file request shown to uploaders.

video_project_idstringoptionalNo description.

dropboxmcp_create_folder#Create a new folder at the specified path in Dropbox.1 param▾

Create a new folder at the specified path in Dropbox.

NameTypeRequiredDescription

pathstringrequiredThe Dropbox path to the file or folder (e.g. /Documents/report.pdf).

dropboxmcp_create_shared_link#Create a shared link for a file or folder with optional access controls.7 params▾

Create a shared link for a file or folder with optional access controls.

NameTypeRequiredDescription

path_or_file_idstringrequiredThe Dropbox path or file ID of the file or folder.

access_levelstringoptionalThe access level for the shared link (viewer, editor).

allow_downloadstringoptionalNo description.

audiencestringoptionalThe audience for the shared link (public, team, no_one).

emailsarrayoptionalNo description.

expiresstringoptionalThe expiration date of the shared link in ISO 8601 format.

passwordstringoptionalAn optional password to protect the shared link.

dropboxmcp_delete#Permanently delete one or more files or folders from Dropbox.1 param▾

Permanently delete one or more files or folders from Dropbox.

NameTypeRequiredDescription

entriesarrayoptionalList of file or folder paths to operate on.

dropboxmcp_download_link#Get temporary download URLs for one or more files.2 params▾

Get temporary download URLs for one or more files.

NameTypeRequiredDescription

entriesarrayrequiredList of file or folder paths to operate on.

expiration_in_secintegeroptionalSeconds until the temporary download URL expires. Must be 0 (no expiry) or between 60 and 900.

dropboxmcp_get_file_content#Retrieve the raw content of a file by path or file ID.1 param▾

Retrieve the raw content of a file by path or file ID.

NameTypeRequiredDescription

path_or_file_idstringrequiredThe Dropbox path or file ID of the file or folder.

dropboxmcp_get_file_metadata#Retrieve metadata for a file or folder by path or file ID.1 param▾

Retrieve metadata for a file or folder by path or file ID.

NameTypeRequiredDescription

path_or_file_idstringrequiredThe Dropbox path or file ID of the file or folder.

dropboxmcp_get_file_request#Retrieve details of a specific file request by its ID.1 param▾

Retrieve details of a specific file request by its ID.

NameTypeRequiredDescription

idstringoptionalThe unique ID of the file request.

dropboxmcp_get_shared_link_metadata#Retrieve metadata for a file or folder from its shared link URL.1 param▾

Retrieve metadata for a file or folder from its shared link URL.

NameTypeRequiredDescription

urlstringoptionalThe shared link URL to retrieve metadata for.

dropboxmcp_get_usage_and_quota#Retrieve the current storage usage and quota for the Dropbox account.0 params▾

Retrieve the current storage usage and quota for the Dropbox account.

dropboxmcp_list_file_requests#List all file requests for the Dropbox account with optional pagination.2 params▾

List all file requests for the Dropbox account with optional pagination.

NameTypeRequiredDescription

cursorstringoptionalPagination cursor from the previous response to fetch the next page.

limitintegeroptionalMaximum number of results to return per page.

dropboxmcp_list_folder#List the contents of a Dropbox folder with optional pagination and filters.5 params▾

List the contents of a Dropbox folder with optional pagination and filters.

NameTypeRequiredDescription

cursorstringoptionalPagination cursor from the previous response to fetch the next page.

max_resultsintegeroptionalMaximum number of results to return.

object_typesarrayoptionalOptional object type filters for the first list_folder call. Valid values: "file" and "folder".

pathstringoptionalThe Dropbox path to the file or folder (e.g. /Documents/report.pdf).

recursivebooleanoptionalIf true, include the contents of all subdirectories.

dropboxmcp_list_shared_links#List shared links for the account or a specific path with pagination.2 params▾

List shared links for the account or a specific path with pagination.

NameTypeRequiredDescription

cursorstringoptionalPagination cursor from the previous response to fetch the next page.

pathstringoptionalThe Dropbox path to the file or folder (e.g. /Documents/report.pdf).

dropboxmcp_move#Move one or more files or folders to a new location in Dropbox.2 params▾

Move one or more files or folders to a new location in Dropbox.

NameTypeRequiredDescription

autorenamebooleanoptionalIf true, renames the destination if a conflict exists.

entriesarrayoptionalList of file or folder paths to operate on.

dropboxmcp_search#Search for files and folders in Dropbox by query with optional filters.12 params▾

Search for files and folders in Dropbox by query with optional filters.

NameTypeRequiredDescription

cursorstringoptionalPagination cursor from the previous response to fetch the next page.

file_categoriesarrayoptionalNo description.

file_extensionsarrayoptionalNo description.

file_statusstringoptionalFilter search results by file status (active or deleted).

filename_onlybooleanoptionalIf true, restricts the search to file and folder names only.

last_modified_afterstringoptionalNo description.

last_modified_beforestringoptionalNo description.

max_resultsintegeroptionalMaximum number of results to return.

order_bystringoptionalField to sort search results by.

pathstringoptionalThe Dropbox path to the file or folder (e.g. /Documents/report.pdf).

querystringoptionalThe search query string to match against file and folder names.

reverse_orderbooleanoptionalIf true, returns results in reverse order.

dropboxmcp_who_am_i#Retrieve the current Dropbox account profile information.0 params▾

Retrieve the current Dropbox account profile information.