X (Twitter)LinkedInGitHubDiscordYouTube

Box MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Box MCP or direct API to search files, retrieve documents, analyze content, and manage permissions through natural language.

Get started for freeGet a demo
Box MCP logoBox MCP
Oauth2

Box MCP is Box's hosted MCP server that exposes enterprise files, folders, and metadata. It provides secure, centralized access to corporate content for search and management.

44 Tools

Try Box MCP now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Box MCP
Try asking
TOOLS

Supported Tools

Every Box MCP action and event your agent gets out of the box.

Add items to hub

Adds files, folders, or web links to a specific hub, enabling content organization within collaborative workspaces.

Ai extract freeform

Extracts metadata from files using Box AI in freeform format without requiring predefined template structures.

Ai extract structured from fields

Extracts structured metadata from files using Box AI based on custom field definitions.

Ai extract structured from fields enhanced

Extracts structured metadata from files using Box AI's Enhanced Extract Agent based on custom field definitions.

Ai extract structured from metadata template

Extracts structured metadata from files using Box AI based on an existing metadata template.

Ai extract structured from metadata template enhanced

Extracts structured metadata from files using Box AI's Enhanced Extract Agent based on an existing metadata template.

Ai qa hub

Ask a question to a Box Hub using Box AI.

Ai qa multi file

Ask a question to multiple files using Box AI.

Ai qa single file

Ask a question to a single file using Box AI.

Copy file

Copies an existing file to a destination folder in Box (see Box API Copy file).

Copy folder

Copies an existing folder to a destination parent folder in Box (see Box API Copy folder).

Copy hub

Creates a copy of an existing Box Hub via the Hubs v3 API (`POST /v3/hubs/{id}:copy`).

Create file comment

Creates a new comment on a specific file.

Create folder

Creates new folders in Box.

Create hub

Creates new collaborative hubs for organizing content around specific topics, projects, or teams.

Create metadata template

Creates a new enterprise metadata template.

Get file content

Get the text content of a file from Box.

Get file details

Gets comprehensive file information from Box.

Get file preview

Displays an interactive preview widget for a Box file directly in chat.

Get folder details

Retrieves comprehensive information about a folder in Box.

Get hub details

Retrieves comprehensive information about a specific hub including metadata, creation details, and administrative information.

Get hub items

Retrieves all items within a specific hub including files, folders, and web links.

Get metadata template schema

Returns the schema for a metadata template.

Get preview page

Use when user asks follow-up question to a file previewed with get_file_preview ("Explain this.

List file comments

Lists all comments on a specific file.

List folder content by folder

Lists files, folders, and web links contained in a folder.

List hubs

Lists all hubs accessible to the current user with pagination support.

List item collaborations

Lists all collaborations for multiple files and folders in a single request.

List metadata templates

Lists available Box metadata templates so you can discover scope and templateKey for search_files_metadata.

List tasks

Lists all tasks associated with a specific file.

Move file

Moves an existing file to another folder in Box using PUT /files/{id} (see Box API Update file).

Move folder

Moves an existing folder to a new parent in Box using PUT /folders/{id} (Update folder).

Search files keyword

Searches for files using keywords and supports metadata filters, file extension filtering (without dots), and field selection.

Search files metadata

Searches for files using SQL-like metadata queries.

Search folders by name

Searches for folders by name within Box using keyword matching.

Set file metadata

Creates or updates a metadata template instance on a file (POST when the template is not yet applied, PUT JSON Patch when it is).

Set folder metadata

Creates or updates a metadata template instance on a folder (POST when the template is not yet applied, PUT JSON Patch when it is).

Update file properties

Updates file metadata: name, description, tags, and collections.

Update folder properties

Updates folder metadata: name, description, tags, and collections.

Update hub

Updates the title or description of a specific hub.

Update metadata template

Updates a metadata template schema (PUT /2.

Upload file

Uploads a new file to Box.

Upload file version

Upload new file version by providing the entire file contents to Box.

Who am i

Returns detailed information about the currently authenticated Box user.

SETUP GUIDE

Connect Box MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for Box MCP
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'YOUR_SPECIFIC_PROMPT_HERE'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect Box MCP API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Box MCP Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'YOUR_SPECIFIC_PROMPT_HERE'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Box MCP actions with your Agent

Why Use Composio?

AI Native Box MCP Integration

  • Supports both Box MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Box MCP data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Box MCP access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Box MCP
  • Scoped, least privilege access to Box MCP resources
  • Full audit trail of agent actions to support review and compliance
FRAMEWORKS

Use Box MCP with any AI Agent Framework

Choose a Framework you want to connect Box MCP with

ChatGPT Work logo

ChatGPT Work

Use Box MCP with ChatGPT Work

Claude Cowork logo

Claude Cowork

Use Box MCP with Claude Cowork

Hermes logo

Hermes

Use Box MCP with Hermes

FAQ

Frequently asked questions

Yes, Box MCP requires you to configure your own OAuth credentials. Once set up, Composio handles token storage, refresh, and lifecycle management for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Box MCP.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Box MCP tool your agent needs.Free to start.

Start building