How to Use the Dropbox MCP in Windsurf

Q: Can Windsurf search my Dropbox files without me specifying the exact path?

Yes, Cascade uses the searchfiles tool to find files by name across your entire account. It then uses getmetadata to confirm it found the correct file before performing any code operations.

Q: Does Windsurf support shared folders on Dropbox?

Yes, the agent uses listsharedfolders and listmountablefolders to discover and navigate shared spaces. It maps out these directories autonomously during multi-step tasks.

Q: How do I check my storage limit?

The agent invokes getspaceusage to retrieve your current storage statistics. It checks total and used bytes so you know exactly how much room remains.

Connect your Dropbox account to Windsurf and let Cascade autonomously navigate directories, manage shared links, and find files.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Dropbox MCP to Windsurf

Create your Vinkius account to connect Dropbox to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Dropbox with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Find files across folders with Windsurf and Cascade

This MCP Server exposes `search_files` so your agent can locate specific assets without manual browsing. Cascade takes your goal, runs the query, and reads the file contents to proceed with your coding task. You don't need to write out the path. Cascade handles the work, checking files by name and immediately pulling metadata via `get_metadata` to verify it has the right version before editing.

Map directory structures autonomously

The `list_folder` tool returns directory metadata, including names, tags, sizes, and modification times. Cascade uses this output to map out project dependencies stored in the cloud. If a folder is shared, the agent chains `list_shared_folders` and `list_mountable_folders` to discover external assets. It handles the traversal sequence in one run, saving you from constant back-and-forth prompting.

Monitor storage allocation dynamically

The `get_space_usage` tool checks your active storage limits and consumed bytes directly from the session. Cascade monitors this data to prevent upload failures or API errors during heavy data runs. Along with usage metrics, the agent runs `get_account` to verify account tier permissions. It keeps your workspace operational by spotting storage bottlenecks before they disrupt your development run.

Setup guide

Set up Dropbox MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Dropbox MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Dropbox payment history." If connected, Cascade will call the Dropbox tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "dropbox-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Dropbox. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Dropbox now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Dropbox MCP in Windsurf

You add the server configuration to your config file. Once connected, the MCP client automatically detects the tools and calls them when you ask to read, search, or list files from your cloud storage.

Yes, Cascade uses the `search_files` tool to find files by name across your entire account. It then uses `get_metadata` to confirm it found the correct file before performing any code operations.

Yes, the agent uses `list_shared_folders` and `list_mountable_folders` to discover and navigate shared spaces. It maps out these directories autonomously during multi-step tasks.

The agent invokes `get_space_usage` to retrieve your current storage statistics. It checks total and used bytes so you know exactly how much room remains.

Your file metadata, directory structures, and account details never leave your local machine. Vinkius runs the MCP Server in an isolated sandbox, meaning the agent only accesses your cloud storage via secure, direct API tokens that you control.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript