box-mcp-server
Usage
You will need:
BOX_USER_ID
and one of the following:
BOX_JWT_BASE64
(recommended)BOX_JWT_CONFIG_PATH
BOX_JWT
Auth
JSON Web Token (JWT) Authorization (recommended)
How to get a JWT
Using a JWT Config allows persistent connection to Box.
You will need a paid Box enterprise account, or you can sign up for a free developer account (make sure you are signed out of Box before clicking that link).
Visit the Box Developer Console and create a new application. Make sure the authorization type is JSON Web Token.
Go to Configuration > Add and Manage Public Keys
and Generate a Public/Private Keypair.
If you have not already, Box prompt you to set up 2 factor authentication and Authorize the application as an administrator in your box account. You will need to:
- give the application
App + Enterprise Access
, and - enable the
make API calls using the as-user header
option
via the Box Application’s Configuration page. Make sure to reauthorize the application if you are modifying these settings.
Base64 encoding JWT
To encode your JWT in Base64, you can use the following command in your terminal:
cat /path/to/your/box-jwt-config.json | base64
Replace /path/to/your/box-jwt-config.json
with the actual path to your JWT configuration file. This will output the Base64 encoded JWT which you can then use in your environment variables.
Claude Desktop Configuration
{
"mcpServers": {
"box": {
"command": "npx",
"args": ["box-mcp-server"],
"env": {
"BOX_JWT_BASE64": "YOUR_BASE64_ENCODED_JWT",
"BOX_USER_ID": "123456"
}
}
}
}
Developer Token Authorization (easiest)
Using a developer token is the easiest way to integrate with Box, but will only last 60 minutes.
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
- Searching files
- Reading files
- [x] PDF
- [x] Word
- [ ] Others
Development
Prerequisites
Before you begin, ensure you have the following installed:
- Node.js (recommended v22 or higher)
- npm
- git
- dotenv
Setting up Development Environment
To set up the development environment, follow these steps:
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
Clone Your Fork:
git clone https://github.com/YOUR_USERNAME/box-mcp-server.git cd box-mcp-server
Add Upstream Remote
git remote add upstream https://github.com/hmk/box-mcp-server.git
Copy the dotenv file
cp .env.template .env
Install dependencies:
npm install
Run watch to keep index.js updated:
npm run watch
Start the model context protocol development server:
dotenv npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.js
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.
Box
Project Details
- hmk/box-mcp-server
- box-mcp-server
- BSD 3-Clause "New" or "Revised" License
- Last Updated: 4/17/2025
Recomended MCP Servers
Analyze user input to identify suitable design patterns and project templates. Orchestrate the project, creating initial files from...
Model Context Protocol (MCP) server for constraint optimization and solving"
On-premises conversational RAG with configurable containers
MCP server for discord bot
MCP servers for interacting with Algolia
这个项目是一个基于Model Context Protocol (MCP)的AutoCAD集成服务器,它允许通过自然语言与AutoCAD进行交互。通过这个服务器,用户可以使用Claude等大型语言模型来创建、修改和分析AutoCAD图纸,同时还可以存储和查询CAD元素的相关数据。目前制作参考学习,仅实现端到端之间的通信,具体工具函数尚未晚上
Code Runner MCP Server
mcp server connected to us treasury data, built with mcp-framework
A Mattermost integration that connects to Model Context Protocol (MCP) servers, leveraging a LangGraph-based Agent.