mcp-server-box
Securely connect AI agents to your enterprise content in Box
Documentation
Box MCP Server
> [!WARNING]
> This repository is discontinued and no longer maintained.
> Box now provides an officially supported hosted MCP server with the best experience and full functionality.
> Please migrate to the hosted MCP server: **Set up the Box MCP Server →**
Quick Start
Clone the repository:
git clone https://github.com/box-community/mcp-server-box.git
cd mcp-server-boxOptional but recommended `uv` installation for virtual environment and dependency management:
Homebrew (macOS)
brew install uvWinGet (Windows)
winget install --id=astral-sh.uv -eOn macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | shOn Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"Set up the virtual environment and install dependencies:
uv syncSet environment variables:
Set the following environment variables for Box authentication in a `.env` file or your system environment.
For comprehensive authentication configuration options, see the Authentication Guide.
Using OAuth2.0 with a Box App
BOX_CLIENT_ID = YOUR_CLIENT_ID
BOX_CLIENT_SECRET = YOUR_CLIENT_SECRET
BOX_REDIRECT_URL = http://localhost:8000/callback
# MCP Server Authentication (for HTTP transports)
BOX_MCP_SERVER_AUTH_TOKEN = YOUR_BOX_MCP_SERVER_AUTH_TOKEN
OAUTH_PROTECTED_RESOURCES_CONFIG_FILE = .oauth-protected-resource.json> Note:
> - The `BOX_MCP_SERVER_AUTH_TOKEN` is used to authenticate the MCP client to the MCP server when using `--mcp-auth-type=token` (independent of Box authentication)
Run the MCP server in STDIO mode:
uv run src/mcp_server_box.pyBox Community MCP Server Tools
Below is a summary of the available tools:
| Tools available | Description |
|---|---|
| box_tools_ai | AI-powered file and hub queries |
| box_tools_collaboration | Manage file/folder collaborations |
| box_tools_docgen | Document generation and template management |
| box_tools_files | File operations (read, upload, download) |
| box_tools_folders | Folder operations (list, create, delete, update) |
| box_tools_generic | Generic Box API utilities |
| box_tools_groups | Group management and queries |
| box_tools_metadata | Metadata template and instance management |
| box_tools_search | Search files and folders |
| box_tools_shared_links | Shared link management for files/folders/web-links |
| box_tools_tasks | Task and task assignment management |
| box_tools_users | User management and queries |
| box_tools_web_link | Web link creation and management |
Box Community MCP Server Operations Details
Command line interface parameters
To run the MCP server with specific configurations, you can use the following command line parameters:
uv run src/mcp_server_box.py --helpusage: mcp_server_box.py [-h] [--transport {stdio,sse,http}] [--host HOST] [--port PORT] [--mcp-auth-type {oauth,token,none}] [--box-auth-type {oauth,ccg,jwt,mcp_client}]
Box Community MCP Server
options:
-h, --help show this help message and exit
--transport {stdio,sse,http}
Transport type (default: stdio)
--host HOST Host for SSE/HTTP transport (default: localhost)
--port PORT Port for SSE/HTTP transport (default: 8005)
--mcp-auth-type {oauth,token,none}
Authentication type for MCP server (default: token)
--box-auth-type {oauth,ccg,jwt,mcp_client}
Authentication type for Box API (default: oauth)For detailed information about authentication types, configurations, and use cases, see the Authentication Guide.
Claude Desktop Configuration
STDIO mode
Edit your `claude_desktop_config.json`:
Add the configuration:{
"mcpServers": {
"mcp-server-box": {
"command": "uv",
"args": [
"--directory",
"/path/to/mcp-server-box",
"run",
"src/mcp_server_box.py"
]
}
}
}
Restart Claude if it is running.
#### HTTP Mode
Assuming your MCP server is running on `https://mcp.myserver.com/mcp`
1. Go to Claude -> Settings -> Connectors
2. Select `Add custom connector`
3. Configurations:
1. Give it a name
2. Enter the URL e.g. `https://mcp.myserver.com/mcp`
3. Optionally enter the `client id` and `client secret`
4. Click add
5. Click connect. The OAuth flow should start. Complete the flow
6. Back in Claude, click Configure. You should see all the tools available.Frequently asked questions
What is mcp-server-box?
mcp-server-box is Securely connect AI agents to your enterprise content in Box
How do I install mcp-server-box?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is mcp-server-box open source?
Yes — it is hosted on GitHub at https://github.com/box-community/mcp-server-box and has 82 stars.
Related MCP tools
openhands🙌 OpenHands: Code Less, Make More for the Model Context Protocol. Enhance AI assistants with powerful integrations. Python-based implementation.
mem0Universal memory layer for AI Agents; Announcing OpenMemory MCP - local and secure memory management. Python-based implementation.
chatgpt-on-wechat基于大模型搭建的聊天机器人，同时支持 微信公众号、企业微信应用、飞书、钉钉 等接入，可选择ChatGPT/Claude/DeepSeek/文心一言/讯飞星火/通义千问/ Gemini/GLM-4/Kimi/LinkAI，能处理文本、语音和图片，访问操作系统和互联网，支持基于自有知识库进行定制企业智能客服。
gpt-researcherAn LLM agent that conducts deep research (local and web) on any given topic and generates a long report with citations. Built for the Model Context Protocol to
fastmcp🚀 The fast, Pythonic way to build MCP servers and clients Trusted by 19900+ developers. Trusted by 19900+ developers. Trusted by 19900+ developers.
maxkb🔥 MaxKB is an open-source platform for building enterprise-grade agents. MaxKB 是强大易用的开源企业级智能体平台。 for the Model Context Protocol. Enhance AI assistants with po
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP