Skip to content

MCP setupDocumentation

Box MCP Server

Connect your coding agent to Box's hosted MCP server to search folders, read files and ask Box AI questions about documents you can already open.

npx workspacetemplates add box-mcp --tool claude-code

Writes 1 file to your project root

.mcp.jsonmerge into your file8 lines · 102 BFile
{
  "mcpServers": {
    "box": {
      "type": "http",
      "url": "https://mcp.box.com"
    }
  }
}

What it does

Box hosts its own remote MCP server at mcp.box.com. The agent can identify the signed-in user, list and search folders, read file content and use Box AI to answer questions about files or pull out metadata.

Access follows your Box permissions, so it reaches only what you could open yourself. An administrator has to switch the server on first, either the predefined Box MCP Server integration or an unlisted one, in the Admin Console under Integrations.

Example

you › In the Q4 Partners folder, find the signed SLA and tell me the uptime target and the credit for missing it.

agent › Found Acme-SLA-signed.pdf. The uptime target is 99.9 percent per month, and missing it earns a 10 percent credit on that month's fee.

Questions

Why does the setup ask for a client ID and secret?
Box uses OAuth 2.0. An admin creates the server in the Admin Console, which produces the client ID and secret, and your MCP client supplies the redirect URI.
Which OAuth scopes does it use?
Box documents root_readwrite, ai.readwrite and docgen.readwrite. The docgen scope needs an Enterprise Advanced license.
Is there a version I can run locally?
Box points to a separate self-hosted project, box-community/mcp-server-box, for that. This item covers only the hosted server.
  • Context7 MCP Server

    MCP setupDocumentation

    Free
  • Notion MCP Server

    MCP setupDocumentation

    Free
  • API Documentation

    SkillDocumentation

    Free
  • Architecture Decision Records

    SkillDocumentation

    Free