Connect Box MCP to your AI agent
Search, retrieve, analyze, and manage enterprise content stored in Box through Box's hosted MCP server.
We set up the connection using your own Box MCP account, with keys you control, and keep it running. Your agent picks it up and starts doing the work.
Actions
What your agent can do in Box MCP
Each one is a real action the agent can take on its own, the same things a person clicking around Box MCP could do. Read-only by default; write actions are confirmed against your policy.
- Add items to hub Adds files, folders, or web links to a specific hub, enabling content organization within collaborative workspaces. Essential for building and curating hub content by adding relevant materials to the collaborative space…
- Ai extract freeform Extracts metadata from files using Box AI in freeform format without requiring predefined template structures. This tool leverages Box AI to extract any type of information from documents using natural language instruct…
- Ai extract structured from fields Extracts structured metadata from files using Box AI based on custom field definitions. This tool leverages Box AI to process documents and return extracted data as structured key-value pairs, supporting various field t…
- Ai extract structured from fields enhanced Extracts structured metadata from files using Box AI's Enhanced Extract Agent based on custom field definitions. This tool leverages Box AI to process documents and return extracted data as structured key-value pairs, s…
- Ai extract structured from metadata template Extracts structured metadata from files using Box AI based on an existing metadata template. This tool leverages Box AI to process documents and return extracted data following the structure defined in a Box metadata te…
- 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. This tool leverages Box AI to process documents and return extracted data following the structure def…
- Ai qa hub Ask a question to a Box Hub using Box AI. This tool leverages Box AI to analyze hub content and provide intelligent responses to questions about the hub's resources, documents, and related materials. Hubs are collaborat…
- Ai qa multi file Ask a question to multiple files using Box AI. This tool leverages Box AI to analyze content across multiple files simultaneously and provide intelligent responses that can compare, contrast, and synthesize information…
- Ai qa single file Ask a question to a single file using Box AI. This tool leverages Box AI to analyze file content and provide intelligent responses to questions about the file. Supports various file types including documents, PDFs, pres…
- Copy file Copies an existing file to a destination folder in Box (see Box API Copy file). The source file is not modified. Provide `parent_folder_id` as the folder that will contain the new copy; use `"0"` for the user's root fol…
- Copy folder Copies an existing folder to a destination parent folder in Box (see Box API Copy folder). The source folder is not modified. Provide `parent_folder_id` as the folder that will contain the new copy; use `"0"` for the us…
- Copy hub Creates a copy of an existing Box Hub via the Hubs v3 API (`POST /v3/hubs/{id}:copy`). The source hub is not modified. Copies the source hub's description (unless overridden) and shareable items into the new hub by sett…
- Create file comment Creates a new comment on a specific file. This tool allows you to add comments to files for collaboration, feedback, or documentation purposes. Comments are visible to all users with access to the file and can be used f…
- Create folder Creates new folders in Box. <examples> Create folder in root: <input> { "name": "Project Documents" } </input> Create folder in specific parent: <input> { "name": "Q4 Reports", "parent_folder_id": "123456789" } </input>…
- Create hub Creates new collaborative hubs for organizing content around specific topics, projects, or teams. Enables the establishment of new collaborative workspaces with customizable titles and descriptions. This tool is essenti…
- Create metadata template Creates a new enterprise metadata template. scope must be "enterprise"; each field needs type, key, and display_name. Optional template_key, hidden, copy_instance_on_item_copy, enum/multiSelect/taxonomy. Enum color_id o…
- Get file content Get the text content of a file from Box. Prefers the markdown representation (preserves document structure for better LLM use) and falls back to extracted text when markdown is not available. If neither representation i…
- Get file details Gets comprehensive file information from Box. Returns essential fields by default (id, name, extension, createdBy, modifiedBy, createdAt, modifiedAt). Use 'fields' parameter to request additional properties. **Common us…
- Get file preview Displays an interactive preview widget for a Box file directly in chat. Supports: ai, bmp, cr2, crw, csv, dng, doc, docx, dwg, eml, eps, gdoc, gif, gsheet, gslide, gslides, heic, htm, html, idml, indd, indt, inx, jpeg,…
- Get folder details Retrieves comprehensive information about a folder in Box. Returns essential fields by default (id, name, createdBy, modifiedBy, createdAt, modifiedAt). Use 'fields' parameter to request additional properties. **Common…
- Get hub details Retrieves comprehensive information about a specific hub including metadata, creation details, and administrative information. Provides complete hub context for understanding ownership, timing, and purpose. This tool is…
- Get hub items Retrieves all items within a specific hub including files, folders, and web links. Essential for exploring the contents of collaborative workspaces and understanding what resources are available in a hub. This tool prov…
- Get metadata template schema Returns the schema for a metadata template. Shield template "securityClassification-6VMVochwUWo": option colorID is normalized from staticConfig (default Yellow=0). Palette: 0=Yellow, 1=Orange, 2=Red, 3=Purple, 4=LightB…
- Get preview page Use when user asks follow-up question to a file previewed with get_file_preview ("Explain this...", "What does ____ mean?")Returns the current preview page as an image so you can analyze it (figures, text, charts, etc.)…
- List file comments Lists all comments on a specific file. Returns a paginated list of comments with configurable fields. Default fields (id, type, message, created_by, created_at) are always returned, but you can specify additional fields…
- List folder content by folder Lists files, folders, and web links contained in a folder. Returns a paginated list of items with at least fields. Fields (id, type, name, etag) are always returned. Use folder_id "0" for the root folder. Supported fiel…
- List hubs Lists all hubs accessible to the current user with pagination support. Provides an overview of available collaborative workspaces and their basic information. Hubs in Box are collaborative workspaces that organize conte…
- List item collaborations Lists all collaborations for multiple files and folders in a single request. This tool efficiently aggregates collaboration information across different item types, making multiple API calls as needed and providing comp…
- List metadata templates Lists available Box metadata templates so you can discover scope and templateKey for search_files_metadata. Use this first to find templates, then get_metadata_template_schema to get field keys. Call with scope "enterpr…
- List tasks Lists all tasks associated with a specific file. This tool retrieves task information including task details, message, status, and completion rule, due date from the Box platform. Tasks in Box are used to assign work to…
- Move file Moves an existing file to another folder in Box using PUT /files/{id} (see Box API Update file). The file stays the same item (same ID); only its parent folder changes. **You must set `parent_folder_id`** to the folder…
- Move folder Moves an existing folder to a new parent in Box using PUT /folders/{id} (Update folder). The folder keeps the same ID; only its parent changes. This is **not** for restoring items from trash. **You must set `parent_fold…
- Search files keyword Searches for files using keywords and supports metadata filters, file extension filtering (without dots), and field selection. Maps to Box's searchForContent API with comprehensive filtering capabilities. The response a…
- Search files metadata Searches for files using SQL-like metadata queries. Requires: from (e.g. enterprise_123456.templateKey from list_metadata_templates), fields (field keys from get_metadata_template_schema). ancestor_folder_id defaults to…
- Search folders by name Searches for folders by name within Box using keyword matching. This tool helps locate specific folders by their names and can be scoped to search within a particular parent folder. Returns basic folder information incl…
- 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). Use list_metadata_templates and get_metadata_template_schema first for scope, template_ke…
- 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). Use list_metadata_templates and get_metadata_template_schema first for scope, template_…
- Update file properties Updates file metadata: name, description, tags, and collections. **Updatable fields:** - `name` - File name with extension (max 255 chars). **IMPORTANT: Always preserve the original file extension unless explicitly inst…
- Update folder properties Updates folder metadata: name, description, tags, and collections. **Updatable fields:** - `name` - Folder name (max 255 chars, no / \ . .. or leading/trailing spaces) - `description` - Folder description (max 256 chars…
- Update hub Updates the title or description of a specific hub. This tool allows you to modify hub settings including title and description to keep hub information current and relevant. You can update one or more properties of a hu…
- Update metadata template Updates a metadata template schema (PUT /2.0/metadata_templates/{scope}/{template_key}/schema). Use scope and template_key from list_metadata_templates or get_metadata_template_schema. Each operation needs op; use camel…
- Upload file Uploads a new file to Box. This tool creates a new file in Box using the provided text content. The file name including the extension must be provided and the extension must match the file content. Markdown uploads (e.g…
- Upload file version Upload new file version by providing the entire file contents to Box. This tool updates an existing file's version in Box using the given file ID and content. The file ID must correspond to an existing file; otherwise,…
- Who am i Returns detailed information about the currently authenticated Box user. This tool provides comprehensive user profile data including basic identification, contact information, role details, and account settings. No inp…
Setup
How we connect it
- 1
Connect your account
You log in with your own Box MCP account. We never see your password, and you can revoke access from Box MCP at any time.
- 2
Set the guardrails
Read-only by default. You choose which write actions the agent may take, and anything outside that policy gets confirmed with you first.
- 3
We keep it running
Health checks on every connection, updates handled for you, and we watch the first week of activity to make sure the work lands.
FAQ
Box MCP questions, answered.
You sign in with your own Box MCP account. Permissions are scoped to the minimum the agent needs, the connection is health-checked, and you can revoke access from Box MCP at any time.
The actions Box MCP's API allows, the same things a person clicking around the app could do. Connections start read-only by default; write actions are confirmed against the policy you set before the agent takes them.
Connections are priced per tool on top of the base plan. Some are included, some are premium. See pricing for how connection charges work.
Standard tools are ready inside 7 business days of the setup call. We test the connection end to end, walk you through how the agent uses it, and watch the first week of activity.
Ready to put Box MCP to work?
Tell us what your team runs on. We set up the connection, secure it, and your agent takes it from there.
All product names, logos, and brands are property of their respective owners; used for identification only. ZeroToClaw is not affiliated with or endorsed by Box MCP.