User and authentication
Manage user authentication and retrieve information about the authenticated user.| Tool | Description |
|---|---|
who_am_i | Returns detailed information about the currently authenticated Box user. |
Content management
Manage files and folders, perform searches, and handle content operations across your Box environment.File operations
| Tool | Description |
|---|---|
get_file_content | Returns the content of a file stored in Box. |
get_file_details | Gets comprehensive file information from Box including metadata, permissions, and version details. |
update_file_properties | Updates file properties, including name, description, tags, and collections. The name can have up to 255 characters (file extension is preserved unless specified otherwise). The description can have up to 256 characters. You can add update up to 100 tags. |
upload_file | Uploads a new file to Box. |
upload_file_version | Uploads a new file version by providing the entire file contents to update an existing file in Box. |
Folder operations
| Tool | Description |
|---|---|
create_folder | Creates a new folder in Box. The new folder can only be created within a parent folder that does not have external collaboration enabled or any shared links. This restriction also applies to the parent’s parent folders. |
get_folder_details | Retrieves comprehensive folder information including metadata, permissions, and collaboration settings. |
list_folder_content_by_folder_id | Lists files, folders, and web links in a folder (paginated). Use folder_id “0” for root. id, type, name, etag are always returned. Optional field: limit. |
update_folder_properties | Updates folder properties, including name, description, tags, and collections. The name can be up to 255 characters and must not include /, \, ., .., or leading or trailing spaces. The description can be up to 256 characters. You can update up to 100 tags. |
Search
| Tool | Description |
|---|---|
search_files_keyword | Searches for files using keywords. Supports metadata filters, file extension filtering, and field selection. |
search_files_metadata | Searches for files using SQL-like metadata queries. Supports complex filtering with parameters, field selection, and folder scoping. |
search_folders_by_name | Searches for folders within Box by name using keyword matching. |
Box AI
Use AI-powered tools to ask questions, extract insights, and analyze content across files and hubs.| Tool | Description |
|---|---|
ai_qa_hub | Ask a question about a Box Hub and get an answer based on the Hub’s content, with citations when available. |
ai_qa_single_file | Asks a question to a single file using Box AI, with citations when available. Text representation up to 1 MB. If larger, only the first 1 MB is processed. |
ai_qa_multi_file | Ask a question about multiple files using Box AI, with citations when available. |
ai_extract_freeform | Extracts metadata from files using Box AI with natural-language prompts (no fixed template). Text representation up to 1 MB. Supports documents, PDFs, presentations, and text. Works with single or multiple file_ids. |
ai_extract_structured | Extracts structured key-value metadata using Box AI Enhanced Extract Agent from custom field definitions. |
ai_extract_structured_from_fields | Extracts structured metadata from files using Box AI and custom field definitions. Supports single and multiple files. Field types include string, date, float, enum, multiSelect. |
ai_extract_structured_from_fields_enhanced | Extracts structured metadata from files using Box AI Enhanced Extract Agent based on custom field definitions. Use only when the user asks for the Enhanced Extract Agent. Higher cost than the standard Box AI Extract tools. Field types include string, date, float, enum, multiSelect. |
ai_extract_structured_from_metadata_template | Extracts structured metadata using an existing Box metadata template. Requires template_key and scope (for example, enterprise or global). Processes the text representation of file content. |
ai_extract_structured_from_metadata_template_enhanced | Extracts structured metadata using an existing Box metadata template with the Enhanced Extract Agent. Use only when the user asks for the Enhanced Extract Agent. Higher cost than the standard Box AI Extract tools. |
Collaboration
Enable team collaboration through comments, shared links, and collaboration management tools.| Tool | Description |
|---|---|
create_file_comment | Creates a new comment on a specific file. Only available for files that do not have external collaborators or shared links. |
list_item_collaborations | List all existing collaborations on an item. |
list_file_comments | Lists all comments on a specific file. |
list_tasks | Lists all tasks associated with a specific file, including status, message, and due dates. |
Hubs
Create and manage Box Hubs for organizing collaborative content and resources around specific topics or projects.| Tool | Description |
|---|---|
add_items_to_hub | Adds files, folders, or web links to a specific hub. Only available for items that do not have external collaborators or shared links. |
copy_hub | Creates a copy of an existing Box Hub with all its structure and settings. The original hub remains unmodified. New title can be up to 50 characters; if omitted, a default one is used. |
create_hub | Creates a new hub. |
get_hub_details | Retrieves detailed information about a specific hub. |
get_hub_items | Gets items (files and folders) associated with a specific hub. |
list_hubs | Lists all hubs accessible to the authenticated user. |
update_hub | Updates the title and description of a specific hub. |
Doc Gen
Automate document generation by using templates with placeholder tags to create customized documents at scale.| Tool | Description |
|---|---|
get_docgen_template_by_id | Retrieves details about a Doc Gen template. |
list_docgen_templates | Lists all Box Doc Gen templates available to the authenticated user. |
create_docgen_batch | Generates documents from a Doc Gen template by filling placeholder tags with provided data. |
create_docgen_template | Marks a Box file (.docx or .pptx) as a Doc Gen template for automated document generation. |