Overview

Dropbox MCP enables secure and standardized file operations in Kuika applications using the Dropbox API.

This integration allows you to:

• List files and folders,
• Download/upload files,
• Copy, move, and create folders.

Configuring Settings via Config Manager

A configuration setting can only be used in a single project. If you want to use it in other projects, you must recreate the same settings.

1. Log in to the Kuika platform.
2. Open the project you want to work on from the Apps screen.
3. Click the Config Manager module in the top menu.

4. To edit an existing configuration, click its name in the list, or create a new configuration using the Create a blank configuration card.
5. Make sure the App Settings tab is selected at the top of the configuration screen.
6. In the left menu, click the MCP option under the INTEGRATIONS heading.
7. Click the Add New link under the Dropbox section.

8. In the Dropbox Settings window that opens, fill in the following fields (all fields are required):

• Name: A unique name for the configuration.
• App Key: The App Key for the application you created in the Dropbox App Console.
• App Secret: The App Secret for the application you created in the Dropbox App Console.

You can access the App Key and App Secret information in the Settings tab of your application in the Dropbox App Console.

9. Click the Create button.
10. You’ll be redirected to your Dropbox account. Grant the necessary permission; once the permission step is complete, you’ll be redirected back to Kuika via the redirect URL.
11. Select the configuration you created from the Dropbox dropdown menu.
12. Click the Save button in the top-right corner to save your changes. (In an existing configuration, this button appears as Update.)

Creating a Dropbox API Key and Secret

‍

1. Go to the Dropbox Developers Apps page.
2. If you are not logged in, log in with your Dropbox account.
3. Click the Create app button.

4. Fill in the app information and create the application.

5. Add the following scopes from the Permissions tab:
   
   • files.metadata.read
   • files.content.read
   • files.content.write
   • sharing.write
   • Account_info.read

6. Go to the Settings tab → Add the following address to the Redirect URIs field:

https://platformapi.kuika.com/v1/api/McpClient/dropbox-callback

7. If you are using a custom domain:

<DOMAIN_NAME>/v1/api/McpClient/dropbox-callback

8. From the same page, obtain the App Key and App Secret Key and add them to the Configuration Manager → Dropbox MCP Settings field.

9. After saving with Create, the Dropbox authorization screen opens → Grant permission with Allow.

Action Types

1. Dropbox Get File Metadata

Retrieves the details of a file or folder.

• Input:
  
  • settings: Connection settings defined in Configuration Manager.
  • path: File or folder path. E.g.: /Documents/report.pdf
• Output:

• tag, name, id, client_modified, server_modified, rev, size, path_display

2. Dropbox List Files

‍

Lists files and folders under a specific folder.

• Input:
  
  • settings
  • path: Folder path. Example: /Projects/Design
• Output:

• tag, name, path_display, size, server_modified_date, client_modified_date

3. Dropbox Download File

Downloads a file.

• Input:
  
  • settings
  • path: File path. E.g.: /Reports/2025-Q1.pdf
• Output:

• uri: Downloadable URI of the file
• mime_type: File type
• content: Base64 encoded content

• encoding: Content encoding information
• metadata: File information

4. Dropbox Upload File

Uploads a file.

• Input:
  
  • settings
  • path: Path of the file to upload.
  • base64Content: File content (Base64)
• Output:

• “success”: true

5. Dropbox Move Item

‍

Moves a file or folder.

• Input:
  
  • Settings
  • from_path: Current path of the item to move
  • to_path: New destination path
• Output:

• “success”: true

6. Dropbox Copy Item

Copies a file or folder.

• Input:
  
  • settings
  • from_path
  • to_path
• Output:

• “success”: true

7. Dropbox Create Folder

‍

Creates a new folder.

• Input:
  
  • settings
  • path: Path of the new folder
• Output:

‍

• “success”: true

Usage in Kuika

Dropbox settings created in Configuration Manager can be used by linking them to the settings parameter in the Dropbox Action in the project.

For example:

• List the /Projects/Design folder,
• Download the /Reports/2025-Q1.pdf file,
• Create a new folder or upload a file.