
Box
Read-only access to Box cloud storage for AI clients: browse, search and read files
- Pricing
- Freemium
- Platforms
- API, CLI, self-hosted
- Runs
- Locally or Remotely
- Version
- 0.2.1
- Listing updated
- today
Similar MCP servers
About Box
Box is a freemium MCP server for files and documents. It can run locally on your machine or as a hosted remote server.
The Box pack is a Model Context Protocol server from Pipeworx that lets an AI client work with files in a Box enterprise account. It can list folder contents from the root or a given folder id, pull metadata for a single file, run keyword searches across names and content, and read the text of plain-text, Markdown and CSV documents.
Access to Box runs through OAuth on the Pipeworx gateway, so the connected user's own permissions decide what is visible. A profile tool reports the signed-in account's login email and how much storage is used against the total. Binary formats such as Office files and PDFs are not converted, and text retrieval is capped at about 100,000 characters with a flag when content is cut off.
The server suits people who want an assistant to find and summarise documents stored in Box without uploading them anywhere. The README describes it as an unofficial integration that is not published by Box.
Install
Run in a terminal
claude mcp add --transport http box https://gateway.pipeworx.io/box/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/box/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"box": {
"url": "https://gateway.pipeworx.io/box/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"box": {
"type": "http",
"url": "https://gateway.pipeworx.io/box/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"box": {
"serverUrl": "https://gateway.pipeworx.io/box/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"box": {
"type": "http",
"url": "https://gateway.pipeworx.io/box/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.
Tools this server provides (5)
Taken from the project documentation; the running server may differ.
- box_list_folder
- List the files and subfolders inside a Box folder.
- box_get_file
- Get full metadata for a single Box file by its file id.
- box_search
- Search a Box account for files and folders matching a query.
- box_get_file_text
- Download and return the text content of a Box file by its file id.
- box_get_user
- Get the signed-in Box user's profile and storage usage.
What it does
- Folder browsing
- Lists the files and subfolders in a folder, defaulting to the root when no id is given.
- File metadata lookup
- Returns size, timestamps, parent folder, shared link and extension for one file id.
- Keyword search
- Searches names and content across the account and can be limited to files or folders.
- Text file reading
- Returns the text of plain-text, Markdown and CSV files, truncated at roughly 100,000 characters.
- Account storage check
- Shows the signed-in user's profile and total versus used storage in bytes.
Good for
- Finding a contract or report in Box by searching for a keyword
- Summarising the text of a Markdown or CSV document stored in Box
- Checking which files sit in a given project folder
- Reporting how much storage the connected Box account is using
Pricing
Freemium, from $49 a month
Free anonymous and free registered tiers; paid credits or subscriptions for higher usage
Prices change. Check pipeworx.io before you buy.
Box FAQ
Which Box file types can be read as text?
The README says the text tool is best for plain-text, Markdown, CSV and similar documents; Office documents, PDFs and images return unreadable bytes.
Do I need an account to use it?
The README says calls are anonymous and capped at 50 a day without a key, and a free Pipeworx account raises the cap to 200 a day.
Is the Box pack official?
No. The README states it is an independent, unofficial integration not affiliated with or endorsed by the upstream provider.
Is Box free?
Box has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.
How do I add Box to Claude Code?
Run this command in your terminal: claude mcp add --transport http box https://gateway.pipeworx.io/box/mcp
What are the best alternatives to Box?
The closest alternatives to Box are Onedrive, Google_drive, Pocket Archive, Docspace and filex.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.