# Dropbox — how to use (mcp.ai)

Dropbox is a cloud storage service offering file syncing, sharing, and collaboration across devices with version control and robust integrations

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_dropbox?ms=1781541840000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `dropbox_create_file_request`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/dropbox`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/dropbox/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/dropbox/create/file/request` — Tool to create a new file request in dropbox. use when you need to request files from others by generating a unique link for uploads to a specified dropbox folder, optionally with a deadline.
  - body: { open?: boolean, title: string, deadline?: object, destination: string }
- `POST https://api.mcp.ai/api/dropbox/create/folder` — Tool to create a new folder at a specified path in dropbox. use when you need to organize files by creating a new directory. requires the 'files.content.write' scope.
  - body: { path: string, autorename?: boolean }
- `POST https://api.mcp.ai/api/dropbox/create/paper` — Creates a new dropbox paper document at the specified path using html or markdown content.
  - body: { path: string, content: string, import_format?: string }
- `POST https://api.mcp.ai/api/dropbox/delete/file/or/folder` — Permanently deletes the file or folder at the specified path in dropbox. use when you need to remove a specific file or folder. requires the `files.content.write` scope.
  - body: { path: string }
- `POST https://api.mcp.ai/api/dropbox/get/about/me` — Tool to get information about the current user's dropbox account. use when you need to retrieve account details like email, name, or account type.
- `POST https://api.mcp.ai/api/dropbox/list/files/in/folder` — Tool to list files and folders in a specified dropbox directory. use when you need to see the contents of a folder, including subfolders if recursive is true.
  - body: { path?: string, limit?: integer, recursive?: boolean, include_deleted?: boolean, include_media_info?: boolean, include_non_downloadable_files?: boolean }
- `POST https://api.mcp.ai/api/dropbox/list/folders` — Retrieves a list of folders, files, and deleted entries from a specified dropbox path.
  - body: { path?: string, limit?: integer, recursive?: boolean, include_deleted?: boolean }
- `POST https://api.mcp.ai/api/dropbox/move/file/or/folder` — Move file or folder
  - body: { to_path: string, from_path: string, autorename?: boolean, allow_shared_folder?: boolean, allow_ownership_transfer?: boolean }
- `POST https://api.mcp.ai/api/dropbox/read/file` — Downloads a file from the specified dropbox path, requiring `files.content.read` scope.
  - body: { path: string }
- `POST https://api.mcp.ai/api/dropbox/search/file/or/folder` — Tool to search for files and folders in dropbox. use when you need to find an item by name or content, optionally within a specific path or with other filters, and paginate through results. example: s
  - body: { query: string, options?: object }
- `POST https://api.mcp.ai/api/dropbox/upload/file` — Uploads a file to a specified path in the user's dropbox, with options for handling existing files.
  - body: { mode?: string, mute?: boolean, path: string, content: object, autorename?: boolean, strict_conflict?: boolean }

## More
- Page: https://mcp.ai/dropbox
- Agent spec (llms.txt): https://mcp.ai/dropbox/llms.txt
- Postman collection: https://mcp.ai/dropbox/postman.json