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.

Name Type Required Description

operation_id string optional The async job ID returned from a previous Dropbox operation.

wait_ms integer optional Milliseconds 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.

Name Type Required Description

autorename boolean optional If true, renames the destination if a conflict exists.

entries array optional List 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.

Name Type Required Description

content string required The text content to write to the new file.

path string required The 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.

Name Type Required Description

closed boolean optional If true, the file request is closed and no longer accepts uploads.

deadline string optional The deadline for the file request in ISO 8601 format.

deadline_allow_late_uploads string optional No description.

description string optional An optional description shown to uploaders.

destination string optional The Dropbox folder path where uploaded files will be saved.

title string optional The title of the file request shown to uploaders.

video_project_id string optional No 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.

Name Type Required Description

path string required The 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.

Name Type Required Description

path_or_file_id string required The Dropbox path or file ID of the file or folder.

access_level string optional The access level for the shared link (viewer, editor).

allow_download string optional No description.

audience string optional The audience for the shared link (public, team, no_one).

emails array optional No description.

expires string optional The expiration date of the shared link in ISO 8601 format.

password string optional An 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.

Name Type Required Description

entries array optional List 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.

Name Type Required Description

entries array required List of file or folder paths to operate on.

expiration_in_sec integer optional Seconds 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.

Name Type Required Description

path_or_file_id string required The 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.

Name Type Required Description

path_or_file_id string required The 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.

Name Type Required Description

id string optional The 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.

Name Type Required Description

url string optional The 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.

Name Type Required Description

cursor string optional Pagination cursor from the previous response to fetch the next page.

limit integer optional Maximum 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.

Name Type Required Description

cursor string optional Pagination cursor from the previous response to fetch the next page.

max_results integer optional Maximum number of results to return.

object_types array optional Optional object type filters for the first list_folder call. Valid values: "file" and "folder".

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

recursive boolean optional If 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.

Name Type Required Description

cursor string optional Pagination cursor from the previous response to fetch the next page.

path string optional The 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.

Name Type Required Description

autorename boolean optional If true, renames the destination if a conflict exists.

entries array optional List 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.

Name Type Required Description

cursor string optional Pagination cursor from the previous response to fetch the next page.

file_categories array optional No description.

file_extensions array optional No description.

file_status string optional Filter search results by file status (active or deleted).

filename_only boolean optional If true, restricts the search to file and folder names only.

last_modified_after string optional No description.

last_modified_before string optional No description.

max_results integer optional Maximum number of results to return.

order_by string optional Field to sort search results by.

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

query string optional The search query string to match against file and folder names.

reverse_order boolean optional If 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.