README.md

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

• PDF
• 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.