Skip to content
API Reference
Admin /Catalog /MCP Servers
Box logo

Box

Storage

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, access policies, 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

Section titled “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

Install

Section titled “Install”
INSTALL

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

  1. Open the catalog

    In your zone’s Keycard Console, 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.

Section titled “Related”
RELATED