# Box

> Box is a freemium MCP server for files and documents. Read-only access to Box cloud storage for AI clients: browse, search and read files. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted, Web
- **Website:** https://pipeworx.io/packs/box
- **Repository:** https://github.com/pipeworx-io/mcp-box
- **MCP Registry name:** io.github.pipeworx-io/box
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents)
- **Listing updated:** 2026-11-18

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http box https://gateway.pipeworx.io/box/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/box/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "box": {
      "url": "https://gateway.pipeworx.io/box/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "box": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/box/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "box": {
      "serverUrl": "https://gateway.pipeworx.io/box/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "box": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/box/mcp"
    }
  }
}
```

## Tools

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

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

## Alternatives

- [Onedrive](https://ai-powered.com/mcp/onedrive): Onedrive is a freemium MCP server for files and documents.
- [Google_drive](https://ai-powered.com/mcp/google-drive-5): Google_drive is a freemium MCP server for files and documents.
- [Pocket Archive](https://ai-powered.com/mcp/pocket-archive): Pocket Archive is a freemium MCP server for files and documents.
- [Docspace](https://ai-powered.com/mcp/docspace): Docspace is an open-source MCP server for files and documents.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [abox.tools](https://ai-powered.com/mcp/abox-tools): abox.tools is an MCP server for files and documents.
- [Pandafile](https://ai-powered.com/mcp/pandafile): Pandafile is a freemium MCP server for files and documents.
- [PaperOffice AI](https://ai-powered.com/mcp/paperoffice-ai): PaperOffice AI is a freemium MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/box
