# Box [Health: Active]

**Category:** 📂 File Systems  
**Repository:** https://github.com/pipeworx-io/mcp-box  
**GitHub Stars:** 0  
**npm Downloads (last month):** 409  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/box

## Description
Box (enterprise cloud storage) MCP Pack

## Tools
Capabilities this server exposes over MCP:

- **box_list_folder** — List the files and subfolders inside a Box (enterprise cloud storage) folder. Pass a folder id, or omit it to list the root folder ("0"). Returns each item's id, type (file or folder), name, size in bytes, and last-modified time. Use to browse a user's Box documents and files.
- **box_get_file** — Get full metadata for a single Box (cloud storage) file by its file id. Returns id, name, size, description, created and modified times, parent folder name, shared link URL, and file extension. Use after listing or searching to inspect one document.
- **box_search** — Search a user's Box (cloud storage) account for files and folders matching a query string across names and content. Optionally restrict to only files or only folders. Returns matching items with id, type, name, size, and last-modified time. Use to find documents by keyword.
- **box_get_file_text** — Download and return the text content of a Box (cloud storage) file by its file id. Best for plain-text, Markdown, CSV, and other text documents; binary formats (Office docs, PDFs, images) will return unreadable bytes. Content is capped at ~100,000 characters and flagged when truncated.
- **box_get_user** — Get the signed-in Box (cloud storage) user's profile: id, name, login email, total storage space (space_amount in bytes), and used storage (space_used in bytes). Use to identify the connected account or report storage usage.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "box": {
    "command": "npx",
    "args": ["-y","@pipeworx/mcp-box"]
  }
}
```

## Documentation

## What Box MCP server does

Box MCP server gives an MCP-compatible agent read access to a connected Box account. Its tools cover five common tasks: browsing folders, searching by name or content, retrieving file metadata, reading text files, and checking the connected user's profile and storage usage.

The integration is designed for discovery and inspection rather than file management. It does not expose tools for uploading, editing, moving, deleting, or sharing files.

## How it works

The package can be reached in two ways. A remote connection uses the Pipeworx gateway at `https://gateway.pipeworx.io/box/mcp`. That endpoint lists the Box-specific tools together with shared Pipeworx gateway tools. The shared tools can route questions across the wider Pipeworx catalog, while the Box tools operate on the connected Box account.

A local installation runs as a stdio MCP process and exposes only the Box pack's tools. It communicates through standard input and output and can be started with `npx -y @pipeworx/mcp-box`.

The gateway also supports direct HTTP tool calls. These require a Pipeworx key and use bearer-token authorization. The remote service must have a connected Box account before its tools can access data.

## Setup and configuration

For an MCP client that supports remote URLs, add the gateway endpoint:

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

For local stdio use, configure the package as follows:

```json
{
  "mcpServers": {
    "box": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-box"]
    }
  }
}
```

The gateway route requires signing in to Pipeworx, connecting Box, and using a Pipeworx key. The local process does not require a Pipeworx gateway account.

## Tools and capabilities

- `box_list_folder` lists items in a specified folder or the Box root when no folder ID is supplied. Results include item IDs, types, names, byte sizes, and modification times.
- `box_search` searches file and folder names and content. Results can be limited to files or folders and include basic identifying and timestamp fields.
- `box_get_file` returns metadata for a file, including its name, size, description, creation and modification times, parent folder name, shared-link URL, and extension.
- `box_get_file_text` retrieves text from a file by ID. It is intended for plain text, Markdown, CSV, and similar formats.
- `box_get_user` returns the signed-in user's ID, name, email, total storage allocation, and used storage.

## Limitations and notes

`box_get_file_text` is not suitable for binary formats such as Office documents, PDFs, or images; those may produce unreadable bytes. Returned text is limited to approximately 100,000 characters and indicates when truncation occurs.

The remote pack endpoint includes shared Pipeworx meta-tools in addition to the Box tools. The local stdio mode exposes only the Box pack. The gateway and local modes use the same Box tool set, but the gateway adds cross-catalog routing through shared tools.

This is an independent, unofficial Box integration. It is not published, endorsed, or affiliated with Box. The package is licensed under MIT.

_Full upstream README: https://allmcps.com/mcp/box/readme_