---
title: Box | Keycard
description: Box's official MCP server for cloud content management, file collaboration, and document operations.
---

Provides full Box platform access including file and folder CRUD, content extraction (markdown and text), interactive file previews, keyword and metadata-based search, collaboration management, commenting, task listing, metadata template discovery, and file uploads. Supports structured metadata queries and multi-item collaboration lookups.

Adding Box provisions three things in your zone: an upstream resource pointing at `https://mcp.box.com/` (kept inside Keycard), a Keycard MCP Gateway URL - the downstream resource - that you install in Cursor, Claude Code, or any MCP client, and a provider for token exchange with Box’s OAuth issuer.

When your AI client makes a tool call, it sends a Keycard-issued access token to the gateway URL. Keycard’s STS exchanges that token for an upstream Box token, the gateway calls the upstream MCP, and the response is proxied back. Your zone’s [identity provider](/admin/identity-providers/index.md), [access policies](/admin/access-policies/index.md), and audit log apply to every call - the upstream credential never leaves Keycard. Each call is recorded in the audit log with the user identity, the resource accessed, and the policy decision.

## Tools

TOOLS

Tools the upstream server exposes through the Keycard MCP Gateway.

Box exposes 21 tools through the gateway:

- create\_file\_comment

  Create a new comment on a specific file for collaboration and feedback

- create\_folder

  Create new folders in Box

- get\_file\_content

  Extract and return file content for files under 50MB (markdown preferred, text fallback)

- get\_file\_details

  Get comprehensive file information from Box

- get\_file\_preview

  Display an interactive preview widget for a Box file directly in chat

- get\_folder\_details

  Retrieve comprehensive information about a folder in Box

- get\_metadata\_template\_schema

  Return the schema for a Box metadata template including all field keys

- get\_preview\_page

  Get the current preview page as an image for follow-up analysis of a previewed file

- list\_file\_comments

  List all comments on a specific file with pagination

- list\_folder\_content\_by\_folder\_id

  List files, folders, and web links in a folder with pagination

- list\_item\_collaborations

  List collaborations for multiple files/folders in one request (up to 10 items)

- list\_metadata\_templates

  List Box metadata templates to discover scope and templateKey

- list\_tasks

  List all tasks associated with a specific file

- search\_files\_keyword

  Keyword search with metadata filters, extension filtering, and field selection

- search\_files\_metadata

  Search files with SQL-like metadata queries

- search\_folders\_by\_name

  Search folders by name with optional ancestor and date range filters

- update\_file\_properties

  Update file metadata: name, description, tags, and collections

- update\_folder\_properties

  Update folder metadata: name, description, tags, and collections

- upload\_file

  Upload a new file with text content to Box

- upload\_file\_version

  Upload a new version of an existing file by full file contents

- who\_am\_i

  Return detailed information about the currently authenticated Box user

Show all 21 tools  Show fewer

## Install

INSTALL

Add Box to your zone and install the gateway URL into Cursor, Claude Code, or any MCP client.

Caution

Installing **Box** requires you to provide a **Client ID** and **Client Secret** from Box’s developer console. Have those ready before you start.

1. **Open the catalog**

   In your zone’s [Keycard Console](https://console.keycard.ai), go to **Applications** → **Add Application** → **Explore MCP Servers**.

2. **Find and install Box**

   Search for `Box` in the catalog and click **Install**. Enter the **Client ID** and **Client Secret** from your Box developer console when prompted.

3. **Connect your development tool**

   Once installed, Box appears on the **Applications** page with a **Keycard MCP Gateway URL**. Use the **Install** dropdown to add it to Cursor, Claude Code, or any MCP-compatible client.

## Related

RELATED

- [Catalog overview](/admin/catalog/index.md) - browse other MCP and API servers
- [Access policies](/admin/access-policies/index.md) - control who can use Box
- [Identity providers](/admin/identity-providers/index.md) - control who can sign in

[PreviousAxiom](/admin/catalog/mcp-servers/axiom/index.md)[NextClose](/admin/catalog/mcp-servers/close-crm/index.md)