Skip to main content

Documentation Index

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

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

Connect the Box MCP server with Cursor to give your AI coding agent direct access to Box content.

Prerequisites

Enable Box 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 cursor://anysphere.cursor-mcp/oauth/callback.
  5. Copy the Client ID and Client Secret for later use. These are required later for Cursor 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.
  7. Click Save.

Use the integration

User

Option 1 — Box plugin

  1. Go to Settings > Plugins > Browse Marketplace and search for Box.
  2. Click Add to Cursor.
  3. Go to Tools and MCPs. Box appears under plugin MCP Servers.
  4. Click Connect (browser opens for OAuth).

Option 2 — Custom MCP connection

  1. Go to Settings > Tools and MCPs > Add Custom MCP (opens mcp.json).
  2. Paste the configuration below, add your client ID and client secret, and save the file.
{
  "mcpServers": {
    "box": {
      "url": "https://mcp.box.com",
      "auth": {
        "CLIENT_ID": "your_client_id",
        "CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}
  1. Return to Cursor settings and click connect to complete authorization.
See Cursor docs for more details: Add Custom MCP - Cursor Docs.