# Dropbox — Pipedream Connect

> Dropbox gives you secure access to all your files. Collaborate with friends, family, and coworkers from any device.

- API slug: `dropbox` (use in MCP headers and tool keys)
- Auth: OAuth (Pipedream-managed)
- Categories: File Storage
- Website: https://www.dropbox.com/
- This page (HTML): https://pipedream.com/apps/dropbox
- Tools: 19 actions · 3 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: dropbox`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "dropbox",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Create a Text File:
const result = await mcp.callTool({
  name: "dropbox-create-a-text-file",
  arguments: {
    name: "File Name",
    path: "Path",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a Dropbox endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://api.dropboxapi.com/2/users/get_account

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkuZHJvcGJveGFwaS5jb20vMi91c2Vycy9nZXRfYWNjb3VudA?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "dropbox-create-a-text-file",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    dropbox: { authProvisionId: "apn_xxxxxxx" },
    name: "File Name",
    path: "Path",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (19)

### `dropbox-create-a-text-file` — Create a Text File (Write)

Creates a brand new text file from plain text content you specify. See the documentation

Full schema: https://pipedream.com/apps/dropbox/actions/create-a-text-file.md

### `dropbox-create-folder` — Create folder (Write)

Create a Folder. See the documentation

Full schema: https://pipedream.com/apps/dropbox/actions/create-folder.md

### `dropbox-create-or-append-to-a-text-file` — Create or Append to a Text File (Write)

Adds a new line to an existing text file, or creates a file if it doesn't exist. See the documentation

Full schema: https://pipedream.com/apps/dropbox/actions/create-or-append-to-a-text-file.md

### `dropbox-create-update-share-link` — Create/Update a Share Link (Write)

Creates or updates a public share link to the file or folder (It allows you to share the file or folder with anyone). See the documentation

Full schema: https://pipedream.com/apps/dropbox/actions/create-update-share-link.md

### `dropbox-delete-file-folder` — Delete a File/Folder (Write)

Permanently removes a file/folder from the server. See documentation

Full schema: https://pipedream.com/apps/dropbox/actions/delete-file-folder.md

### `dropbox-download-and-export` — Download and Export (Read-only)

Export a file from a user's Dropbox. If file is not exportable, it will be downloaded in original format. See the documentation

Full schema: https://pipedream.com/apps/dropbox/actions/download-and-export.md

### `dropbox-download-file-preview` — Download File Preview (Write)

Download a file preview from Dropbox. See the documentation

Full schema: https://pipedream.com/apps/dropbox/actions/download-file-preview.md

### `dropbox-download-file-to-tmp` — Download File to TMP (Write)

Download a specific file to the temporary directory. See the documentation.

Full schema: https://pipedream.com/apps/dropbox/actions/download-file-to-tmp.md

### `dropbox-get-shared-link-file` — Get Shared Link File (Read-only)

Get a file from a shared link. See the documentation

Full schema: https://pipedream.com/apps/dropbox/actions/get-shared-link-file.md

### `dropbox-get-shared-link-metadata` — Get Shared Link Metadata (Read-only)

Retrieves the shared link metadata for a given shared link. See the documentation

Full schema: https://pipedream.com/apps/dropbox/actions/get-shared-link-metadata.md

### `dropbox-list-file-folders-in-a-folder` — List All Files/Subfolders in a Folder (Read-only)

Retrieves a list of files or subfolders in a specified folder See the documentation

Full schema: https://pipedream.com/apps/dropbox/actions/list-file-folders-in-a-folder.md

### `dropbox-list-file-revisions` — List File Revisions (Read-only)

Retrieves a list of file revisions needed to recover previous content. See the documentation

Full schema: https://pipedream.com/apps/dropbox/actions/list-file-revisions.md

### `dropbox-list-shared-links` — List Shared Links (Read-only)

Retrieves a list of shared links for a given path. See the documentation

Full schema: https://pipedream.com/apps/dropbox/actions/list-shared-links.md

### `dropbox-move-file-folder` — Move a File/Folder (Write)

Moves a file or folder to a different location in the user's Dropbox See the documentation

Full schema: https://pipedream.com/apps/dropbox/actions/move-file-folder.md

### `dropbox-rename-file-folder` — Rename a File/Folder (Write)

Renames a file or folder in the user's Dropbox See the documentation

Full schema: https://pipedream.com/apps/dropbox/actions/rename-file-folder.md

### `dropbox-restore-a-file` — Restore a File (Write)

Restores a previous file version. See the documentation

Full schema: https://pipedream.com/apps/dropbox/actions/restore-a-file.md

### `dropbox-search-files-folders` — Search files and folders (Read-only)

Searches for files and folders by name. See the documentation

Full schema: https://pipedream.com/apps/dropbox/actions/search-files-folders.md

### `dropbox-upload-file` — Upload a File (Write)

Uploads a file to a selected folder. See the documentation

Full schema: https://pipedream.com/apps/dropbox/actions/upload-file.md

### `dropbox-upload-multiple-files` — Upload Multiple Files (Write)

Uploads multiple file to a selected folder. See the documentation

Full schema: https://pipedream.com/apps/dropbox/actions/upload-multiple-files.md

## Triggers (3)

### `dropbox-new-file` — New File (Instant)

Emit new event when a new file is added to your account or a specific folder. Make sure the number of files/folders in the watched folder does not exceed 4000.

Full schema: https://pipedream.com/apps/dropbox/triggers/new-file.md

### `dropbox-new-folder` — New Folder (Instant)

Emit new event when a new folder is created. Make sure the number of files/folders in the watched folder does not exceed 4000.

Full schema: https://pipedream.com/apps/dropbox/triggers/new-folder.md

### `dropbox-all-updates` — New or Modified File or Folder (Instant)

Emit new event when a file or folder is added or modified. Make sure the number of files/folders in the watched folder does not exceed 4000.

Full schema: https://pipedream.com/apps/dropbox/triggers/all-updates.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt