Box

Provides Box file search and read capabilities via MCP using a Box Developer Token.

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-mirror-hmk_box-mcp-server": {
      "command": "npx",
      "args": [
        "box-mcp-server"
      ],
      "env": {
        "BOX_DEV_TOKEN": "YOUR_DEV_TOKEN_HERE"
      }
    }
  }
}

You can run the Box MCP Server to allow an MCP client to search and read files stored in Box. It uses a Box Developer Token for authentication and exposes capabilities through a local, standard input/output (stdio) server that you run with a simple command.

How to use

Use a compatible MCP client to connect to the Box MCP Server. The server operates locally and authenticates with a Box Developer Token you provide via environment variables. Once running, you can perform file search and file read operations against your Box files through the MCP client, enabling streamlined access to PDFs, Word documents, and other supported formats.

How to install

Prerequisites you need before installing: Node.js v22 or higher, npm, and git.

Step by step commands you will run locally:

# 1) Ensure Node.js and npm are installed (Node.js v22+)
node -v
npm -v

# 2) Ensure git is installed
git --version

# 3) Install or run the MCP server via npx (no local install required for testing)
# Replace YOUR_DEV_TOKEN_HERE with your Box Developer Token
export BOX_DEV_TOKEN=YOUR_DEV_TOKEN_HERE
npx box-mcp-server

Configuration and usage notes

The Box MCP Server is configured to read the Box Developer Token from the BOX_DEV_TOKEN environment variable. If you prefer integrating with a configuration setup, you can specify the MCP server in your client configuration as shown in the example below.

{
  "mcpServers": {
    "box": {
      "command": "npx",
      "args": [
        "box-mcp-server"
      ],
      "env": {
        "BOX_DEV_TOKEN": "YOUR_DEV_TOKEN_GOES_HERE"
      }
    }
  }
}

Available tools

search_files

Search for files in Box that match given criteria and return metadata such as name, type, and path.

read_file

Read the contents of a file from Box, supporting formats like PDF and Word where available.