Box Developer Documentation

Remote Box MCP server

Remote Box MCP server

Remote Box MCP server is a standardized way for AI Agents to connect and interact with third-party applications like Box, enabling seamless access to content and AI capabilities across platforms. The Box MCP server acts as a bridge that allows leading AI Agent platforms — such as Copilot Studio, Claude Enterprise, Mistral Le Chat — to securely query and utilize Box data and AI-powered tools without exposing raw file content. Through OAuth authorization, users can grant AI Agents controlled access to their Box accounts, enabling intelligent document handling, advanced search, and multi-file AI queries directly within these external AI environments.

Access and manage predefined Box MCP servers

  1. Click Integrations in the sidebar of Box Admin Console.
  2. Use Categories filter and choose MCP or search for a predefined Box MCP server in the search field search at the top of the window.
  3. Beside the selected MCP server, click the state, then select the state you want to enable.

MCP

Create an unlisted Box MCP server

  1. Click Integrations in the sidebar of Box Admin Console.
  2. Search for Box MCP server in the search field search at the top of the window.
  3. Hover on the Box MCP server application, then click Configure.
  4. In the Additional Configuration section, click on + Add Integration Credentials.
  5. Copy the generated Client ID and Client Secret.
  6. Enter the Redirect URI provided by the external MCP Client.
  7. Under Scopes, ensure that Manage AI Requests is selected.

Add Box MCP server on the Client Side

To connect to Box from the AI Agent platform, you need to:

  • Endpoint URL: https://mcp.box.com
  • Client ID and Client Secret: Box generates these in the Integration Credentials section of your Admin Console when configuring the Box MCP server, above.
  • Pass an MCP name: box-remote-mcp
  • Provide an authorization_token

Exact steps may vary depending on the AI platform. Refer to your platform’s documentation for client-side setup instructions. Check this sample code for reference:

response = await client.beta.messages.create(
    model="claude-3-opus-20240229",  # Or your preferred model
    max_tokens=4096,
    messages=conversation_history,
    mcp_servers=[
        {
            "type": "url",
            "url": "https://mcp.box.com",
            "name": "box-remote-mcp",
            "authorization_token": BEARER_TOKEN,
        }
    ],
    betas=["mcp-client-2025-04-04"]
)

Claude

To start using the remote Box MCP server in Claude, go to Claude app settings and click Connectors. Within this view click Browse connectors and choose Box. Ensure to grant Claude access to Box.

See a demo video that showcases how to connect Box MCP with the Claude desktop app.

Copilot Studio

To add the remote Box MCP server, follow the instructions provided by the Copilot Studio side. Detailed steps and guidance are available in the official Microsoft documentation: Add an MCP Server in Copilot Studio.

Azure API Center

To add the remote Box MCP server in Azure API Center's Enterprise Registry, follow the instructions provided by Azure. Detailed steps and guidance are available in the official Microsoft documentation: Add an MCP Server in Azure API Center's Enterprise Registry.

Anthropic's Messages API

Connect the remote Box MCP server with Anthropic's Messages API. Clone this sample chat bot project to get started quickly. It allows you to have a conversation with an Anthropic model, which has access to tools provided by the Box remote MCP server.

Watch a video that features a demo project, a React based chat bot that leverages remote Box MCP.

Mistral AI’s Le Chat

To enable Box MCP for Mistral AI’s Le Chat, visit connectors page, click Connect and grant access to Box. Alternatively, directly form the chat view, click Tools and choose Box.

MCP

Using Box AI Features with the MCP Server

When you use Box AI in third-party applications, you can achieve the best experience and highest quality results by accessing the applications through the Box MCP server. This ensures full functionality, improved performance, and a seamless user experience.

Available tools

Remote Box MCP server includes several tools you can use:

ToolDescription
who_am_iReturns detailed information about the currently authenticated Box user.
get_file_contentReturns content of a file stored in Box
search_folders_by_nameSearches for folders within Box by name using keyword matching.
list_folder_content_by_folder_idLists files, folders, and web links in a folder.
search_files_keywordSearches for files using keywords. Supports metadata filters, file extension filtering, and field selection.
search_files_metadataSearches for files using SQL-like metadata queries. Supports complex filtering with parameters, field selection, and folder scoping.
ai_qa_single_fileAsks a question to a single file using Box AI.
ai_qa_multi_fileAsks a question to multiple files using Box AI.
ai_qa_hubAsks a question to a Box Hub using Box AI.
ai_extract_freeformExtracts metadata from files using Box AI in freeform format without requiring predefined template structures.
ai_extract_structuredExtracts structured metadata from files using Box AI based on either custom fields definition or an existing metadata template.