How to Use the Box MCP in Windsurf

Q: How do I add this Box server to Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the server configuration under the MCP servers config key. Alternatively, use the Settings UI under Cascade to paste the Vinkius URL and click refresh.

Q: Can Windsurf find text inside my Box PDFs?

Yes, Cascade uses the searchcontent tool to run deep text queries. It filters by docx, pdf, or xlsx extensions to pinpoint the exact specifications you need.

Q: How does Cascade handle enterprise user lists?

The agent invokes listusers to fetch the directory. This helps it map file ownership and collaboration permissions for your team.

Let Windsurf browse Box folders, find enterprise documents, and manage files autonomously using Cascade.

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

Cascade crawls Box via this MCP Server

This Box MCP Server exposes `list_folder_items` so Windsurf can inspect your files starting from root folder "0". Cascade analyzes the folder structure, determines where your assets live, and updates its plan without you clicking around. When Cascade needs details, it triggers `get_folder_info` or `get_file_info` to read metadata. You get a clear view of your storage hierarchy without leaving the editor.

Deep content search across documents

The `search_content` tool lets your Windsurf agent find text inside PDFs, Word documents, and spreadsheets. Cascade runs these searches to extract context from your enterprise storage when you ask questions about project specs. It filters results by file extensions like xlsx or docx. This means Cascade doesn't waste time reading irrelevant files when resolving a code issue.

Automated folder setup and collaboration check

The `create_folder` tool handles workspace generation, defaulting new folders to root if you don't specify a parent. Cascade sets up the directories your project needs and instantly verifies who has access. Running `get_folder_collaborations` lets Windsurf see who is assigned to each directory. It lists users with `list_users` to make sure your team members are on the invite list before starting a build.

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-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

Open your `~/.codeium/windsurf/mcp_config.json` file and add the server configuration under the MCP servers config key. Alternatively, use the Settings UI under Cascade to paste the Vinkius URL and click refresh.

Yes, Cascade uses the `search_content` tool to run deep text queries. It filters by docx, pdf, or xlsx extensions to pinpoint the exact specifications you need.

Root access is fully supported by passing ID "0" to the folder tools. Cascade automatically starts its search there when mapping your directory tree.

The agent invokes `list_users` to fetch the directory. This helps it map file ownership and collaboration permissions for your team.

Your folder structures and user lists never persist on Vinkius. Every request runs inside an ephemeral, zero-trust V8 isolate that destroys itself immediately after execution.

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