---
asIndexPage: true
---

# Dropbox

import ToolInfo from "@/app/_components/tool-info";
import Badges from "@/app/_components/badges";
import TabbedCodeBlock from "@/app/_components/tabbed-code-block";
import TableOfContents from "@/app/_components/table-of-contents";
import ToolFooter from "@/app/_components/tool-footer";
import { Callout } from "nextra/components";

<ToolInfo
  description="Enable agents to interact with files and folders in Dropbox."
  author="Arcade"
  codeLink="https://github.com/ArcadeAI/arcade-ai/tree/main/resources/integrations/dropbox"
  authType="oauth2"
  versions={["0.1.0"]}
/>

<Badges repo="arcadeai/arcade_dropbox" />

The Arcade Dropbox MCP Server provides a pre-built set of tools for interacting with Dropbox. These tools make it easy to build agents and AI apps that can:

- Browse files and folders
- Search for files and folders
- Download files

## Available Tools

<TableOfContents
  headers={["Tool Name", "Description"]}
  data={[
    ["Dropbox.ListItemsInFolder", "List all items in a folder."],
    [
      "Dropbox.SearchFilesAndFolders",
      "Search for files and folders in Dropbox.",
    ],
    ["Dropbox.DownloadFile", "Download a file from Dropbox."],
  ]}
/>

<Callout>
  If you need to perform an action that's not listed here, you can [get in touch
  with us](mailto:contact@arcade.dev) to request a new tool, or [create your own
  tools](/guides/create-tools/tool-basics/build-mcp-server).
</Callout>

## Dropbox.ListItemsInFolder

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool Directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/dropbox/list_items_in_folder_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/dropbox/list_items_in_folder_example_call_tool.js",
        ],
      },
    },
  ]}
/>

List all items in a folder.

**Parameters**

- **folder_path** _(string, required)_ Path to the folder. E.g. '/My Documents/My Folder'
- **limit** _(int, optional, Defaults to `100`)_ Maximum number of items to return. Defaults to 100. Maximum allowed is 2000.
- **cursor** _(string, optional)_ A cursor to use for pagination. Defaults to `None`.

## Dropbox.SearchFilesAndFolders

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool Directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/dropbox/search_files_and_folders_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/dropbox/search_files_and_folders_example_call_tool.js",
        ],
      },
    },
  ]}
/>

Search for files and folders in Dropbox.

**Parameters**

- **keywords** _(string, required)_ The keywords to search for. E.g. 'quarterly report'
- **search_in_folder_path** _(string, optional)_ Restricts the search to the specified folder path. E.g. '/My Documents/My Folder'. Defaults to `None` (search in the entire Dropbox).
- **filter_by_category** _(list of enum [DropboxItemCategory](/resources/integrations/productivity/dropbox/reference#dropboxitemcategory), optional)_ Restricts the search to the specified category(ies) of items. Defaults to `None` (returns all items).
- **limit** _(int, optional, Defaults to `100`)_ Maximum number of items to return. Defaults to 100. Maximum allowed is 2000.
- **cursor** _(string, optional)_ A cursor to use for pagination. Defaults to `None`.

## Dropbox.DownloadFile

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool Directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/dropbox/download_file_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/dropbox/download_file_example_call_tool.js",
        ],
      },
    },
  ]}
/>

Download a file from Dropbox.

**Parameters**

- **file_path** _(string, optional)_ Path to the file. E.g. '/My Documents/My Folder/My File.pdf'
- **file_id** _(string, optional)_ The ID of the file to download. E.g. 'id:a4ayc_80_OEAAAAAAAAAYa'

Note: to call this tool, you must provide either `file_path` or `file_id`.

## Auth

The Arcade Dropbox MCP Sever uses the [Dropbox auth provider](/references/auth-providers/dropbox) to connect to users' Dropbox accounts.

With the Arcade Cloud Platform, there's nothing to configure. Your users will see `Arcade` as the name of the application that's requesting permission.

With a self-hosted installation of Arcade, you need to [configure the Dropbox auth provider](/references/auth-providers/dropbox#configuring-dropbox-auth) with your own Dropbox app credentials.

<ToolFooter pipPackageName="arcade_dropbox" />