How to Use the Box MCP in Windsurf

Q: How do I connect the Box MCP Server to Windsurf?

Add the server configuration to your /.codeium/windsurf/mcpconfig.json file under the mcpServers key. Alternatively, open Settings, go to Cascade, and use the MCP Servers UI to paste your Vinkius endpoint.

Q: Can Windsurf Cascade create nested Box folder structures?

Yes. Cascade chains createfolder calls by taking the folder ID returned from the first run and passing it as the parent ID for the next nested directory.

Q: How does Windsurf handle collaborator roles in Box?

Cascade executes createcollaboration using the target user's email, the folder ID, and your specified role like "editor" or "viewer".

Q: What happens if Cascade tries to delete a non-empty Box folder?

Cascade will check the directory contents and call deletefolder with the recursive flag set to true to ensure all nested items are deleted.

Let Windsurf Cascade manage your Box folders, search assets, and provision teammate access autonomously.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Box MCP to Windsurf

Create your Vinkius account to connect Box 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 Box with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Box folder provisioning in Windsurf

The `create_folder` tool lets Cascade build out directory structures in your Box account starting from the root folder. If Cascade needs to set up a new project workspace, it calls this tool with parent ID "0" and immediately gets to work organizing your files. Once the folder exists, the agent chains `create_collaboration` to invite users by email as editors or viewers. This lets Cascade handle onboarding flows on your behalf without requiring you to click through the Box web interface.

Deep search and metadata inspection via Cascade

The `search_content` tool exposes Box's search engine directly to Cascade so it can locate files when you do not know their exact IDs. Cascade executes the query, finds the relevant matches, and immediately feeds those IDs into the next step of its plan. To inspect specific files, Cascade uses `get_file_info` to read the file size, version history, and SHA1 hashes. It can also run `get_folder_info` to trace who created a directory and when it was last modified.

Direct file maintenance with this MCP Server

The `update_file` tool gives Windsurf Cascade the ability to rename files or update their descriptions on the fly. When Cascade generates new assets or refactors code, it modifies the Box metadata to keep your cloud storage in sync with your local workspace. For cleanup tasks, Cascade invokes `delete_file` or `delete_folder` to remove stale files. If a directory contains items, Cascade sets the recursive flag to true to wipe the folder clean in a single operation.

Setup guide

Set up Box 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 Box 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 Box payment history." If connected, Cascade will call the Box tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "box-alternative-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 Box. 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 Box 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 Box MCP in Windsurf

Add the server configuration to your `~/.codeium/windsurf/mcp_config.json` file under the `mcpServers` key. Alternatively, open Settings, go to Cascade, and use the MCP Servers UI to paste your Vinkius endpoint.

Yes. Cascade chains `create_folder` calls by taking the folder ID returned from the first run and passing it as the parent ID for the next nested directory.

Cascade executes `create_collaboration` using the target user's email, the folder ID, and your specified role like "editor" or "viewer".

Cascade will check the directory contents and call `delete_folder` with the recursive flag set to true to ensure all nested items are deleted.

Your Box files, folder structures, and collaborator emails never touch Vinkius servers permanently. Vinkius runs this MCP Server inside an isolated sandbox, acting as a secure proxy that passes API calls directly to Box.

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