> ## 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.

# Cursor

Connect the Box MCP server with [Cursor](https://www.cursor.com/) to give your AI coding agent direct access to Box content.

## Prerequisites

* A Box enterprise account with the MCP server enabled by an admin. See [Set up the MCP server](/guides/box-mcp/setup).
* [Cursor](https://www.cursor.com/) installed.

## Enable Box integration in Box

<Badge color="orange" size="lg">Admin</Badge>

1. Sign in to the [Box Admin Console](https://app.box.com/master).
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

<Badge color="green" size="lg">User</Badge>

### 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.

```json theme={null}
{
  "mcpServers": {
    "box": {
      "url": "https://mcp.box.com",
      "auth": {
        "CLIENT_ID": "your_client_id",
        "CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}
```

3. Return to Cursor settings and click connect to complete authorization.

See Cursor docs for more details: [Add Custom MCP - Cursor Docs](https://docs.cursor.com/mcp/add-custom-mcp).