Box — Claude Code MCP server: what it does, how to install
Connects Box to an MCP client for file search, text reading, Box AI questions, data extraction, and folder operations.
no license updated 2026-10-29
Open on GitHubWhat Box does
Box is a Python MCP server that works with Box files and folders through the Box API. Its tools can search by name, description, file content, comments, or tags; read a file’s text; locate folders; and list their contents. File upload and download are supported, as are folder creation, updates, and deletion.
The server exposes separate tools for Box AI questions and structured extraction. box_ask_ai_tool sends a prompt about a selected file, while box_ai_extract_data returns requested fields as JSON. The project uses box-sdk-gen, and the client configuration starts src/mcp_server_box.py through uv.
You need Python 3.13 or newer, uv, and Box API credentials. Put BOX_CLIENT_ID and BOX_CLIENT_SECRET in .env; without them, the server cannot connect to Box.
What it helps with
- search Box files by content and metadata
- read a document using its
file_id - ask Box AI about a selected file
- extract document fields as JSON
- upload or download files through Box
Example prompts for the agent
- Search Box for documents matching “financial report” inside folder
12345. - Read the file with
file_id1728677291168and summarize its contents. - Extract the fields “title, date, amount” from file
1728677291168and return JSON.
How to install Box
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Box
How do I install Box in Claude Code?
Clone the repository with git clone https://github.com/box-community/mcp-server-box.git, enter it with cd mcp-server-box, install uv, create an environment with uv venv, activate it with source .venv/bin/activate, and run uv lock. Then add BOX_CLIENT_ID and BOX_CLIENT_SECRET to .env and configure uv to launch src/mcp_server_box.py.
What does Box do?
This MCP server gives an AI client tools for searching, reading, uploading, and downloading Box files. It can also inspect folders, ask Box AI questions, and return extracted data as JSON.
What does Box require to run?
It requires Python 3.13 or newer and Box API credentials, including BOX_CLIENT_ID and BOX_CLIENT_SECRET. The project uses box-sdk-gen.