Box MCP Server
An MCP server capable of interacting with the Box API
Overview
MCP Server Box is a Python project that integrates with the Box API to perform various operations such as file search, text extraction, AI-based querying, and data extraction. It leverages the box-sdk-gen library to facilitate seamless integration with the Box API.
To use MCP Server Box, clone the repository, set up your environment, and run the server using the provided commands. You will need to configure your Box API credentials in a .env file.
- File search capabilities within Box. - Text extraction from Box files. - AI-based querying for file content. - Data extraction using AI techniques. - Tools for user information retrieval and application authorization.
- Searching for specific files in Box based on various criteria.
- Extracting text from documents stored in Box.
- Utilizing AI to query and analyze file content.
- Managing and processing Box data efficiently.
Add to your AI client
Use these steps to connect Box MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"mcp-server-box-box-community": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-box-box-community"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"mcp-server-box-box-community": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-box-box-community"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mcp-server-box-box-community": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-box-box-community"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mcp-server-box-box-community": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-box-box-community"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-server-box-box-community": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-box-box-community"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mcp-server-box-box-community": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-box-box-community"
]
}
}
}FAQ
What programming language is MCP Server Box written in?
MCP Server Box is written in Python.
Do I need Box API credentials to use this project?
Yes, you need to create a `.env` file with your Box API credentials to use the project.
How do I run the MCP Server?
You can run the MCP Server using the command: `uv --directory /path-to-the-project/mcp-server-box run src/mcp_server_box.py`.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1945,"uuid":"2029adb5-c3c3-4c5b-890a-743644b747c9","name":"mcp-server-box","title":"Box MCP Server","description":"An MCP server capable of interacting with the Box API","avatar_url":"https://avatars.githubusercontent.com/u/8659759?v=4","created_at":"2025-03-05T07:26:51.868Z","updated_at":"2025-03-12T10:21:43.900Z","status":"created","author_name":"box-community","author_avatar_url":"https://avatars.githubusercontent.com/u/8659759?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/box-community/mcp-server-box","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"31\",\"license\":\"\",\"language\":\"Python\",\"is_official\":false,\"latest_commit_time\":\"2025-05-19 11:36:00\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]