box-mcp-server
About
box-mcp-server is an MCP (Model Context Protocol) server that integrates with Box’s cloud storage to search and read files. It is intended for developers using AI assistants like Claude to access Box content.
Details
- Author
- MCP-Mirror
- Downloads
- 295
- Categories
- Other, Developer Tools
Jump to
- Searches files stored in Box
- Reads file content
- Supports PDF documents
- Supports Word documents
- Authenticates via Box Developer Token only
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
box-mcp-serverCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Configure the server in your Claude Desktop configuration by running npx box-mcp-server with the environment variable BOX_DEV_TOKEN set to a Box Developer Token. Obtain a developer token from a Box application created in the developer console.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"box-mcp-server": {
"hmk_box-mcp-server": {
"command": "npx",
"args": [
"@modelcontextprotocol/inspector",
"node",
"PATH_TO_YOUR_CLONED_REPO/dist/index.js"
]
}
}
}
}McpServers
{
"hmk_box-mcp-server": {
"command": "npx",
"args": [
"@modelcontextprotocol/inspector",
"node",
"PATH_TO_YOUR_CLONED_REPO/dist/index.js"
]
}
}box-mcp-server
Usage
Developer Token Authorization
This MCP server currently supports only Developer Token authentication.To get started, set the BOX_DEV_TOKEN to a Box Developer Token.
Begin by visiting the Box Developer Console and create a new application. The authorization type does not currently matter, as all support Box Developer Token.
Once your application is created, navigate to its configuration setings and click Generate Developer Token.
Claude Desktop Configuration
{
"mcpServers": {
"box": {
"command": "npx",
"args": [
"box-mcp-server"
],
"env": {
"BOX_DEV_TOKEN": "YOUR_DEV_TOKEN_GOES_HERE"
}
}
}
}
Capabilities
1. Searching files
2. Reading files
- [x] PDF
- [x] Word
- [ ] Others
Development
Prerequisites
Before you begin, ensure you have the following installed:
Node.js (v22 or higher)
npm
git
Setting up Development Environment
To set up the development environment, follow these steps:
1. Fork the repository
Click the "Fork" button in the top-right corner of this repository
* This creates your own copy of the repository under your Github acocunt
2. Clone Your Fork:
git clone https://github.com/YOUR_USERNAME/box-mcp-server.git
cd box-mcp-server
3. Add Upstream Remote
git remote add upstream https://github.com/hmk/box-mcp-server.git
4. Install dependencies:
npm install
5. Set the BOX_DEV_TOKEN environment variable:
export BOX_DEV_TOKEN=your_developer_token
6. Run watch to keep index.js updated:
npm run watch
7. Start the model context protocol development server:
npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.js
8. If the development server did not load the environment variable correctly, set the BOX_DEV_TOKEN on the left-hand side of the mcp inspector.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
