Box

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:

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

For local stdio use, configure the package as follows:

{
  "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.