Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.box.com/llms.txt

Use this file to discover all available pages before exploring further.

Prerequisites

  • A Box enterprise account with the MCP server enabled by an admin. See Set up the MCP server.
  • Claude Code installed (npm install -g @anthropic-ai/claude-code).

Enable integration in Box

Admin
  1. Sign in to the Box Admin Console.
  2. Go to Integrations and find Custom Box MCP Server either by using the MCP Category filter, or by using the search bar at the top of the page.
  3. Go to Configuration > Add Integration Credentials to generate new credentials.
  4. In Redirect URIs, change the Box redirect URIs to http://localhost:PORT/callback. (You can use any callback port for this.)
  5. Copy the Client ID and Client Secret for later use. These are required later for Claude Code to authorize the connection.
  6. Check the Access scopes:
    • Scopes define the maximum set of actions. Users can only access content they already have permission to view or edit in Box.
    • Read all files and folders stored in Box.
    • Read and write all files and folders stored in Box.
    • Manage AI Requests.

Use the integration

User
  1. In CLI, run the following command and replace YOUR-CLIENT-ID and PORT with the values set in the Admin console.
claude mcp add-json box-mcp \
  '{"type":"http","url":"https://mcp.box.com","oauth":{"clientId":"YOUR-CLIENT-ID","callbackPort":PORT}}' \
  --client-secret
  1. Paste the Client Secret and press enter to open a browser tab for OAuth.

Verify the connection

After adding the server, start Claude Code and run /mcp to confirm box-mcp is listed and connected. You can then ask Claude Code to interact with your Box content using the available tools. See Anthropic’s docs for details: Connect Claude Code to tools via MCP - Claude Code Docs.