How to integrate Dropbox MCP with Mastra AI

This guide walks you through connecting Dropbox to Mastra AI using the Composio tool router. By the end, you'll have a working Dropbox agent that can list files in your shared projects folder, create a new folder for invoices, search for last month's sales report through natural language commands. This guide will help you understand how to give your Mastra AI agent real control over a Dropbox account through Composio's Dropbox MCP server. Before we dive in, let's take a quick look at the key ideas and tools involved.

Get started for freeGet a demo
Dropbox logoDropbox
Oauth2

Dropbox is a cloud storage service for file syncing, sharing, and collaboration. It keeps your files accessible, organized, and safe across all your devices.

174 Tools

Introduction

This guide walks you through connecting Dropbox to Mastra AI using the Composio tool router. By the end, you'll have a working Dropbox agent that can list files in your shared projects folder, create a new folder for invoices, search for last month's sales report through natural language commands.

This guide will help you understand how to give your Mastra AI agent real control over a Dropbox account through Composio's Dropbox MCP server.

Before we dive in, let's take a quick look at the key ideas and tools involved.

Also integrate Dropbox with

ChatGPTOpenAI Agents SDKClaude Agent SDKClaude CodeClaude CoworkCodexOpenCodeCursorVS CodeOpenClawHermesCLIGoogle ADKLangChainVercel AI SDKLlamaIndexCrewAI

TL;DR

Here's what you'll learn:
  • Set up your environment so Mastra, OpenAI, and Composio work together
  • Create a Tool Router session in Composio that exposes Dropbox tools
  • Connect Mastra's MCP client to the Composio generated MCP URL
  • Fetch Dropbox tool definitions and attach them as a toolset
  • Build a Mastra agent that can reason, call tools, and return structured results
  • Run an interactive CLI where you can chat with your Dropbox agent

What is Mastra AI?

Mastra AI is a TypeScript framework for building AI agents with tool support. It provides a clean API for creating agents that can use external services through MCP.

Key features include:

  • MCP Client: Built-in support for Model Context Protocol servers
  • Toolsets: Organize tools into logical groups
  • Step Callbacks: Monitor and debug agent execution
  • OpenAI Integration: Works with OpenAI models via @ai-sdk/openai

What is the Dropbox MCP server, and what's possible with it?

The Dropbox MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Dropbox account. It provides structured and secure access to your cloud files, so your agent can perform actions like searching, uploading, organizing, reading, and deleting files and folders on your behalf.

  • Smart file search and retrieval: Ask your agent to search for files or folders by name, keyword, or within specific directories, and quickly locate what you need.
  • Automated file uploads and folder creation: Direct your agent to create new folders for organization or request file uploads with unique shareable links, streamlining content collection and storage.
  • Seamless file reading and downloads: Have your agent read the contents of any file or download important documents from your Dropbox, whenever you need them.
  • Effortless organization and cleanup: Let your agent move, delete, or reorganize files and folders to keep your Dropbox tidy and efficient.
  • Account insights and management: Retrieve up-to-date details about your Dropbox account, including user info and storage status, for complete oversight.

What is the Composio tool router, and how does it fit here?

What is Composio SDK?

Composio's Composio SDK helps agents find the right tools for a task at runtime. You can plug in multiple toolkits (like Gmail, HubSpot, and GitHub), and the agent will identify the relevant app and action to complete multi-step workflows. This can reduce token usage and improve the reliability of tool calls. Read more here: Getting started with Composio SDK

The tool router generates a secure MCP URL that your agents can access to perform actions.

How the Composio SDK works

The Composio SDK follows a three-phase workflow:

  1. Discovery: Searches for tools matching your task and returns relevant toolkits with their details.
  2. Authentication: Checks for active connections. If missing, creates an auth config and returns a connection URL via Auth Link.
  3. Execution: Executes the action using the authenticated connection.

Step-by-step Guide

Step by step09 STEPS
1

Prerequisites

Before starting, make sure you have:
  • Node.js 18 or higher
  • A Composio account with an active API key
  • An OpenAI API key
  • Basic familiarity with TypeScript
2

Getting API Keys for OpenAI and Composio

OpenAI API Key
  • Go to the OpenAI dashboard and create an API key.
  • You need credits or a connected billing setup to use the models.
  • Store the key somewhere safe.
Composio API Key
  • Log in to the Composio dashboard.
  • Go to Settings and copy your API key.
  • This key lets your Mastra agent talk to Composio and reach Dropbox through MCP.
3

Install dependencies

bash
npm install @composio/core @mastra/core @mastra/mcp @ai-sdk/openai dotenv

Install the required packages.

What's happening:

  • @composio/core is the Composio SDK for creating MCP sessions
  • @mastra/core provides the Agent class
  • @mastra/mcp is Mastra's MCP client
  • @ai-sdk/openai is the model wrapper for OpenAI
  • dotenv loads environment variables from .env
4

Set up environment variables

bash
COMPOSIO_API_KEY=your_composio_api_key_here
COMPOSIO_USER_ID=your_user_id_here
OPENAI_API_KEY=your_openai_api_key_here

Create a .env file in your project root.

What's happening:

  • COMPOSIO_API_KEY authenticates your requests to Composio
  • COMPOSIO_USER_ID tells Composio which user this session belongs to
  • OPENAI_API_KEY lets the Mastra agent call OpenAI models
5

Import libraries and validate environment

typescript
import "dotenv/config";
import { openai } from "@ai-sdk/openai";
import { Agent } from "@mastra/core/agent";
import { MCPClient } from "@mastra/mcp";
import { Composio } from "@composio/core";
import * as readline from "readline";

import type { AiMessageType } from "@mastra/core/agent";

const openaiAPIKey = process.env.OPENAI_API_KEY;
const composioAPIKey = process.env.COMPOSIO_API_KEY;
const composioUserID = process.env.COMPOSIO_USER_ID;

if (!openaiAPIKey) throw new Error("OPENAI_API_KEY is not set");
if (!composioAPIKey) throw new Error("COMPOSIO_API_KEY is not set");
if (!composioUserID) throw new Error("COMPOSIO_USER_ID is not set");

const composio = new Composio({
  apiKey: composioAPIKey as string,
});
What's happening:
  • dotenv/config auto loads your .env so process.env.* is available
  • openai gives you a Mastra compatible model wrapper
  • Agent is the Mastra agent that will call tools and produce answers
  • MCPClient connects Mastra to your Composio MCP server
  • Composio is used to create a Tool Router session
6

Create a Tool Router session for Dropbox

typescript
async function main() {
  const session = await composio.create(
    composioUserID as string,
    {
      toolkits: ["dropbox"],
    },
  );

  const composioMCPUrl = session.mcp.url;
  console.log("Dropbox MCP URL:", composioMCPUrl);
What's happening:
  • create spins up a short-lived MCP HTTP endpoint for this user
  • The toolkits array contains "dropbox" for Dropbox access
  • session.mcp.url is the MCP URL that Mastra's MCPClient will connect to
7

Configure Mastra MCP client and fetch tools

typescript
const mcpClient = new MCPClient({
    id: composioUserID as string,
    servers: {
      nasdaq: {
        url: new URL(composioMCPUrl),
        requestInit: {
          headers: session.mcp.headers,
        },
      },
    },
    timeout: 30_000,
  });

console.log("Fetching MCP tools from Composio...");
const composioTools = await mcpClient.getTools();
console.log("Number of tools:", Object.keys(composioTools).length);
What's happening:
  • MCPClient takes an id for this client and a list of MCP servers
  • The headers property includes the x-api-key for authentication
  • getTools fetches the tool definitions exposed by the Dropbox toolkit
8

Create the Mastra agent

typescript
const agent = new Agent({
    name: "dropbox-mastra-agent",
    instructions: "You are an AI agent with Dropbox tools via Composio.",
    model: "openai/gpt-5",
  });
What's happening:
  • Agent is the core Mastra agent
  • name is just an identifier for logging and debugging
  • instructions guide the agent to use tools instead of only answering in natural language
  • model uses openai("gpt-5") to configure the underlying LLM
9

Set up interactive chat interface

typescript
let messages: AiMessageType[] = [];

console.log("Chat started! Type 'exit' or 'quit' to end.\n");

const rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout,
  prompt: "> ",
});

rl.prompt();

rl.on("line", async (userInput: string) => {
  const trimmedInput = userInput.trim();

  if (["exit", "quit", "bye"].includes(trimmedInput.toLowerCase())) {
    console.log("\nGoodbye!");
    rl.close();
    process.exit(0);
  }

  if (!trimmedInput) {
    rl.prompt();
    return;
  }

  messages.push({
    id: crypto.randomUUID(),
    role: "user",
    content: trimmedInput,
  });

  console.log("\nAgent is thinking...\n");

  try {
    const response = await agent.generate(messages, {
      toolsets: {
        dropbox: composioTools,
      },
      maxSteps: 8,
    });

    const { text } = response;

    if (text && text.trim().length > 0) {
      console.log(`Agent: ${text}\n`);
        messages.push({
          id: crypto.randomUUID(),
          role: "assistant",
          content: text,
        });
      }
    } catch (error) {
      console.error("\nError:", error);
    }

    rl.prompt();
  });

  rl.on("close", async () => {
    console.log("\nSession ended.");
    await mcpClient.disconnect();
    process.exit(0);
  });
}

main().catch((err) => {
  console.error("Fatal error:", err);
  process.exit(1);
});
What's happening:
  • messages keeps the full conversation history in Mastra's expected format
  • agent.generate runs the agent with conversation history and Dropbox toolsets
  • maxSteps limits how many tool calls the agent can take in a single run
  • onStepFinish is a hook that prints intermediate steps for debugging

Complete Code

Here's the complete code to get you started with Dropbox and Mastra AI:

typescript
import "dotenv/config";
import { openai } from "@ai-sdk/openai";
import { Agent } from "@mastra/core/agent";
import { MCPClient } from "@mastra/mcp";
import { Composio } from "@composio/core";
import * as readline from "readline";

import type { AiMessageType } from "@mastra/core/agent";

const openaiAPIKey = process.env.OPENAI_API_KEY;
const composioAPIKey = process.env.COMPOSIO_API_KEY;
const composioUserID = process.env.COMPOSIO_USER_ID;

if (!openaiAPIKey) throw new Error("OPENAI_API_KEY is not set");
if (!composioAPIKey) throw new Error("COMPOSIO_API_KEY is not set");
if (!composioUserID) throw new Error("COMPOSIO_USER_ID is not set");

const composio = new Composio({ apiKey: composioAPIKey as string });

async function main() {
  const session = await composio.create(composioUserID as string, {
    toolkits: ["dropbox"],
  });

  const composioMCPUrl = session.mcp.url;

  const mcpClient = new MCPClient({
    id: composioUserID as string,
    servers: {
      dropbox: {
        url: new URL(composioMCPUrl),
        requestInit: {
          headers: session.mcp.headers,
        },
      },
    },
    timeout: 30_000,
  });

  const composioTools = await mcpClient.getTools();

  const agent = new Agent({
    name: "dropbox-mastra-agent",
    instructions: "You are an AI agent with Dropbox tools via Composio.",
    model: "openai/gpt-5",
  });

  let messages: AiMessageType[] = [];

  const rl = readline.createInterface({
    input: process.stdin,
    output: process.stdout,
    prompt: "> ",
  });

  rl.prompt();

  rl.on("line", async (input: string) => {
    const trimmed = input.trim();
    if (["exit", "quit"].includes(trimmed.toLowerCase())) {
      rl.close();
      return;
    }

    messages.push({ id: crypto.randomUUID(), role: "user", content: trimmed });

    const { text } = await agent.generate(messages, {
      toolsets: { dropbox: composioTools },
      maxSteps: 8,
    });

    if (text) {
      console.log(`Agent: ${text}\n`);
      messages.push({ id: crypto.randomUUID(), role: "assistant", content: text });
    }

    rl.prompt();
  });

  rl.on("close", async () => {
    await mcpClient.disconnect();
    process.exit(0);
  });
}

main();

Conclusion

You've built a Mastra AI agent that can interact with Dropbox through Composio's Tool Router. You can extend this further by:
  • Adding other toolkits like Gmail, Slack, or GitHub
  • Building a web-based chat interface around this agent
  • Using multiple MCP endpoints to enable cross-app workflows
TOOLS

Supported Tools

Every Dropbox action and event your agent gets out of the box.

Activate team folder

Tool to activate an archived team folder.

Add file member

Tool to add specified members to a Dropbox file with configurable access levels.

Add file properties

Tool to add custom properties to a Dropbox file using a filled property template.

Add tag to file or folder

Tool to add a tag to a file or folder in Dropbox.

Add folder member

Tool to add members to a shared folder with specified access levels.

Add users to space limits exclusion list

Tool to add users to the team's space limits exclusion list in Dropbox.

Add sharing allowlist

Tool to add domains or email addresses to the team sharing allowlist.

Add members to team group

Tool to add members to a team group with specified access levels.

Add team members

Tool to add new members to a Dropbox team.

Add secondary emails to team members

Tool to add secondary email addresses to Dropbox team members.

Add property template for team

Tool to add a property template for a team in Dropbox.

Alpha Upload File

Tool to upload a new file to Dropbox using the alpha upload endpoint.

Append data to upload session

Tool to append more data to an existing upload session.

Append to multiple upload sessions

Tool to append data to multiple upload sessions in a single request.

Archive team folder

Tool to archive an active team folder in Dropbox.

Check copy batch job status

Tool to check the status of an asynchronous copy batch job in Dropbox.

Check delete batch status

Tool to check the status of an asynchronous delete batch job in Dropbox.

Check folder batch status

Tool to check the status of an asynchronous folder batch creation job.

Check sharing job status

Tool to check the status of an asynchronous sharing job in Dropbox.

Check move batch job status

Tool to check the status of an asynchronous move batch job.

Check move former member files job status

Tool to check the status of an asynchronous move former member files job.

Check remove member job status

Tool to check the status of an asynchronous remove folder member job in Dropbox.

Check save URL job status

Tool to check the status of a save_url job in Dropbox.

Check share job status

Tool to check the status of an asynchronous folder sharing job in Dropbox.

Check team folder archive status

Tool to check the status of an asynchronous team folder archive job in Dropbox.

Check upload batch status

Tool to check the status of an asynchronous upload batch job in Dropbox.

Check user

Tool to test Dropbox API connection and validate access token by echoing back a supplied string.

Copy multiple files or folders

Tool to copy multiple files or folders to different locations at once in Dropbox.

Copy file or folder

Tool to copy a file or folder to a different location in Dropbox.

Count file requests

Tool to get the total number of file requests owned by the authenticated user.

Create file request

Tool to create a new file request in Dropbox.

Create folder

Tool to create a new folder at a specified path in Dropbox.

Create multiple folders

Tool to create multiple folders at once in Dropbox.

Create paper document

Creates a new Dropbox Paper document at the specified path using HTML or Markdown content.

Create Paper folder

Tool to create a new Paper folder with the provided info.

Create shared link

Tool to create a stable, long-lived shared link for a Dropbox file or folder.

Create team folder

Tool to create a new, active team folder with no members in Dropbox.

Create team group

Tool to create a new, empty team group in Dropbox with a specified name.

Delete all closed file requests

Tool to delete all closed file requests owned by the current user.

Delete multiple files/folders

Tool to delete multiple files or folders at once in Dropbox.

Delete file or folder

Tool to delete a file or folder at the specified path in Dropbox.

Delete file requests

Tool to delete a batch of closed file requests in Dropbox.

Delete manual contacts batch

Tool to delete specific manually added contacts from Dropbox by their email addresses.

Permanently delete archived team folder

Tool to permanently delete an archived team folder in Dropbox.

Delete team group

Tool to delete a Dropbox team group.

Delete team member profile photo

Tool to delete a team member's profile photo.

Delete team members secondary emails

Tool to delete secondary email addresses from Dropbox team members.

Download Folder as Zip

Tool to download a folder from Dropbox as a zip file.

Export File

Tool to export non-downloadable Dropbox files (especially Dropbox Paper) to Markdown/HTML/plain text and return usable content.

Search files and folders

Tool to search for files and folders in Dropbox by name or content.

Finish upload session

Tool to finish an upload session and save the uploaded data to the given file path.

Finish batch upload sessions

Tool to commit many files at once into a user's Dropbox after uploading file contents via upload_session/start and upload_session/append.

Get about me

Tool to get information about the current user's Dropbox account.

Get account

Tool to get information about a user's Dropbox account using their account ID.

Get account batch

Tool to get information about multiple user accounts in a single request.

Get available team member roles

Tool to retrieve all available team member roles for the connected Dropbox team.

Get copy reference

Tool to get a copy reference to a file or folder.

Get file lock batch

Tool to return lock metadata for multiple files in a single batch request.

Get shared file metadata batch

Tool to retrieve metadata for multiple shared files in a single batch request.

Get file preview

Tool to get a preview for a file.

Get file request details

Tool to retrieve details of an existing file request by ID.

Get file or folder tags

Tool to get list of tags assigned to files or folders in Dropbox.

Get folder state cursor

Tool to get a cursor representing the current state of a folder without listing its contents.

Get JWKS

Tool to retrieve JSON Web Key Set containing public verification keys for Dropbox signed ID tokens.

Get file or folder metadata

Tool to fetch metadata for a file or folder by path.

Get file or folder metadata (alpha)

Tool to fetch metadata for a file or folder using the alpha endpoint.

Get OpenID config

Tool to retrieve Dropbox's OpenID Connect discovery document describing supported OAuth 2.

Get shared file metadata

Tool to retrieve metadata for a shared file in Dropbox.

Get shared folder metadata

Tool to retrieve metadata for a specific shared folder by its ID.

Download file from shared link

Tool to download a file from a Dropbox shared link.

Get shared link metadata

Tool to resolve a Dropbox shared link URL into structured metadata.

Get space usage

Tool to get space usage information for the current user's Dropbox account.

Get team feature values

Tool to get values for one or more team features.

Get team folder info

Tool to retrieve metadata for team folders.

Get team groups info

Tool to retrieve information about one or more team groups by their IDs or external IDs.

Get team groups job status

Tool to check the status of an asynchronous team groups job in Dropbox.

Get team info

Tool to retrieve information about a Dropbox team.

Get team audit log events

Tool to retrieve team audit log events from Dropbox.

Get team log events (continue)

Tool to paginate through team audit log events using a cursor from team_log/get_events.

Get team member custom quota

Tool to retrieve custom storage quotas for team members.

Get team members add job status v2

Tool to poll the status of an asynchronous team member addition job.

Get team members info

Tool to retrieve information about multiple team members in a single request.

Get property template for team

Tool to get the schema for a specified property template for a team.

Get temporary link

Tool to get a one-click temporary (expiring) download link.

Get temporary upload link

Tool to get a one-time use temporary upload link to upload a file to Dropbox.

Get thumbnail

Tool to get a thumbnail for an image file.

Get thumbnail batch

Tool to get thumbnails for multiple image files in a single batch request.

Get thumbnail v2

Tool to get a thumbnail for an image file.

Get user features

Tool to get a list of feature values configured for the current Dropbox account.

List member space limits excluded users (continue)

Tool to paginate through team members excluded from space limits using a cursor from a previous list call.

List file members

Tool to obtain the members who have been invited to a file, both inherited and uninherited members.

List file members batch

Tool to get members of multiple files at once.

List file requests

Tool to list all file requests owned by the current user.

List file requests (continue)

Tool to paginate through file requests using a cursor from a previous list call.

List file revisions

Tool to retrieve the revision history for a file.

List files in folder

Tool to list files and folders in a specified Dropbox directory.

List folder continue

Tool to continue paginating through folder contents using a cursor from list_folder.

List folder members

Tool to list members of a shared folder, including users, groups, and invitees.

List folder members continue

Tool to continue paginating through shared folder members using a cursor from list_folder_members.

List shared folders continue

Tool to continue paginating through shared folders using a cursor from list_folders.

List member linked apps

Tool to list all applications linked to a specific team member's account.

List excluded users from space limits

Tool to list team members excluded from space limits.

List mountable folders

Tool to list all shared folders the current user can mount or unmount.

List mountable folders continue

Tool to paginate through mountable shared folders using a cursor.

List Paper docs

Tool to return the list of all Paper docs according to filter and sort specifications.

List Paper documents (continue)

Tool to continue paginating through Paper documents using a cursor from paper/docs/list.

List received files

Tool to list all files shared with the current user.

List shared folders

Tool to list all shared folders the authenticated user has access to.

List shared links

Tool to list existing shared links for the current user, optionally filtered by path.

List team sharing allowlist

Tool to list Approve List entries for a team from newest to oldest.

List team devices

Tool to list all device sessions of a team including web sessions, desktop clients, and mobile clients.

List team folders

Tool to list all team folders for a Dropbox Business team.

List team folders continue

Tool to continue paginating through team folders using a cursor from team_folder/list.

List team group members

Tool to list members of a Dropbox team group.

List team groups

Tool to list all groups on a Dropbox team.

List team groups continue

Tool to continue listing team groups using a cursor from team/groups/list.

List team group members continue

Tool to continue listing team group members using a cursor from team/groups/members/list.

List members linked apps

Tool to list all applications linked to team members' accounts.

List team member devices

Tool to list all device sessions of a team's member, including web sessions, desktop clients, and mobile clients.

List team members

Tool to list members of a Dropbox team.

List team members continue (v2)

Tool to continue listing team members using a cursor from team/members/list or team/members/list/continue_v2.

List team namespaces

Tool to list all team-accessible namespaces in a Dropbox Business team.

List team namespaces continue

Tool to continue paginating through team-accessible namespaces using a cursor from team/namespaces/list.

List team sharing allowlist continue

Tool to continue paginating through team sharing allowlist entries using a cursor.

List property templates for team

Tool to list all property templates for a team.

List user templates

Tool to get the template identifiers for a user.

Modify shared link settings

Tool to modify settings of an existing Dropbox shared link.

Mount shared folder

Tool to mount a shared folder for the current user after they have been added as a member.

Move multiple files or folders in batch

Tool to move multiple files or folders to different locations at once in Dropbox.

Move file or folder

Move file or folder

Overwrite file properties

Tool to overwrite property groups associated with a file or folder.

Read a file

Downloads a file from the specified Dropbox path, requiring `files.

Remove file member

Tool to remove a specified member from a file's sharing permissions.

Remove File Properties

Tool to permanently remove specified property groups from a file or folder.

Remove file properties template for team

Tool to remove a property template from a team.

Remove tag from file or folder

Tool to remove a tag from a file or folder in Dropbox.

Remove folder member

Tool to remove a member from a shared folder.

Remove group members

Tool to remove members from a Dropbox team group.

Remove sharing allowlist

Tool to remove domains or email addresses from the team sharing allowlist.

Remove team member custom quota

Tool to remove custom storage quota for team members, reverting them to the team's default quota.

Remove member space limits excluded users

Tool to remove users from the member space limits excluded users list.

Rename team folder

Tool to rename an existing team folder in Dropbox.

Resend secondary email verification

Tool to resend secondary email verification emails to team members.

Restore file to specific revision

Tool to restore a specific revision of a file to the given path in Dropbox.

Revoke shared link

Tool to revoke a Dropbox shared link.

Save copy reference

Tool to save a copy reference to the user's Dropbox.

Save file from URL

Tool to save a file to Dropbox directly from a public URL via server-side fetch.

Continue Dropbox Search

Tool to fetch the next page of search results from a previous Dropbox search.

Search File or Folder

Tool to search for files and folders in Dropbox by name or content, optionally scoped to a path, with pagination support.

Search File Properties

Tool to search across property templates for particular property field values.

Send team member welcome email

Tool to send a welcome email to a pending team member.

Set profile photo

Tool to set the profile photo for the current user's Dropbox account.

Set team member custom quota

Tool to set custom storage quotas for team members in Dropbox.

Share folder

Tool to share a folder with collaborators in Dropbox.

Start upload session

Tool to start a new upload session with the given data.

Start batch of upload sessions

Tool to start a batch of upload sessions.

Unlock multiple files

Tool to unlock multiple files at specified paths in a single batch operation.

Unmount shared folder

Tool to unmount a shared folder for the current user.

Unshare file

Tool to remove all members from a Dropbox file.

Unshare folder

Tool to allow a shared folder owner to unshare the folder.

Update file member

Tool to change a member's access level on a shared file.

Update file properties

Tool to update custom properties on a file or folder in Dropbox.

Update file request

Tool to update an existing file request in Dropbox.

Update folder member

Tool to update another member's permissions in a shared folder.

Update folder policy

Tool to update the sharing policies for a shared folder.

Set group member access type

Tool to change a member's access type in a team group.

Update Paper Document

Tool to update an existing Dropbox Paper document with new content in Markdown, HTML, or plain text format.

Update property template for team

Tool to update a property template for a team in Dropbox.

Update team folder sync settings

Tool to update the sync settings on a team folder or its contents in Dropbox.

Update team group

Tool to update a team group's name, external ID, and/or management type.

Set team member admin permissions

Tool to update a team member's admin permissions.

Set team member profile

Tool to update a team member's profile information.

Set team member profile photo

Tool to update a team member's profile photo.

Upload File

Uploads a file (up to ~150 MB) to a specified path in the user's Dropbox, with options for handling existing files.

FRAMEWORKS

How to build Dropbox MCP Agent with another framework

ChatGPT logo

ChatGPT

Use Dropbox MCP with ChatGPT

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Dropbox MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Dropbox MCP with Claude Agent SDK

Claude Code logo

Claude Code

Use Dropbox MCP with Claude Code

Claude Cowork logo

Claude Cowork

Use Dropbox MCP with Claude Cowork

Codex logo

Codex

Use Dropbox MCP with Codex

Cursor logo

Cursor

Use Dropbox MCP with Cursor

OpenClaw logo

OpenClaw

Use Dropbox MCP with OpenClaw

Hermes logo

Hermes

Use Dropbox MCP with Hermes

CLI logo

CLI

Use Dropbox MCP with CLI

Google ADK logo

Google ADK

Use Dropbox MCP with Google ADK

LangChain logo

LangChain

Use Dropbox MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Dropbox MCP with Vercel AI SDK

LlamaIndex logo

LlamaIndex

Use Dropbox MCP with LlamaIndex

CrewAI logo

CrewAI

Use Dropbox MCP with CrewAI

OpenCode logo

OpenCode

Use Dropbox MCP with OpenCode

VS Code logo

VS Code

Use Dropbox MCP with VS Code

FAQ

Frequently asked questions

With a standalone Dropbox MCP server, the agents and LLMs can only access a fixed set of Dropbox tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Dropbox and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Mastra AI fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Dropbox tools.

Yes, absolutely. You can configure which Dropbox scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Dropbox data and credentials are handled as safely as possible.

Start with Dropbox.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Dropbox tool your agent needs.Free to start.

Start building
Customer stories

Teams ship real agents on Composio

GET STARTED FOR FREEBOOK A DEMO
agent.aiZoomLettaGleanHubSpotAWSWabi

Karan skipped his own birthday party to fix our critical issue. It was 10pm and he diverted his Waymo to help us instead. This really sets the bar — it shows the commitment you need when users rely on your software.

Harsha Gaddipati
Harsha Gaddipati
Co-founder, Slashy

A lot of students tell us that the moment their connected tools start talking to each other inside Opennote feels almost magical. The agent just knows them, and it's immensely helped keep new users on the platform.

Abhi Arya
Abhi Arya
Co-founder, Opennote

We chose Composio over Pipedream because it delivered depth where it mattered — niche tools and tricky edge cases other platforms simply ignored. That gave us confidence to scale without compromising.

Nirman Dave
Nirman Dave
CEO, Zams

As a solo builder, shipping fast is life or death. The only way I can outcompete incumbents is by outmanoeuvring them. Getting bogged down managing agent auth would have been a death sentence.

Ryan Yu
Ryan Yu
Founder, Extra Thursday

Before Composio, adding tool integrations was slow and resource-intensive. Each one could take weeks of engineering time, and maintaining them meant constantly keeping up with API changes.

Tomisin Jenrola
Tomisin Jenrola
Founder & CEO, SwarmZero

With hands-on help from their founder, we integrated Gmail and Google Drive in just 30 minutes. This level of personal support and commitment is exactly what startups should strive for.

Jerome Leclanche
Jerome Leclanche
Co-Founder, Ingram Technologies