An MCP server capable of interacting with the Box API.
2.3K
2
36 Tools
Version 4.43 or later needs to be installed to add the server automatically
Use cases
About
An MCP server capable of interacting with the Box API.
Attribute | Details |
---|---|
Docker Image | mcp/box |
Author | box-community |
Repository | https://github.com/box-community/mcp-server-box |
Dockerfile | https://github.com/box-community/mcp-server-box/blob/refs/pull/4/merge/Dockerfile |
Docker Image built by | Docker Inc. |
Docker Scout Health Score | |
Verify Signature | COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/box --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub |
Licence |
Tools provided by this Server | Short Description |
---|---|
box_ai_ask_file_multi_tool | Ask Box AI about multiple files. |
box_ai_ask_file_single_tool | Ask Box AI about a single file. |
box_ai_ask_hub_tool | Ask Box AI about a specific hub. |
box_ai_extract_freeform_tool | Extract data from files in Box using AI with a freeform prompt. |
box_ai_extract_structured_enhanced_using_fields_tool | Extract structured data from files in Box using AI with specified fields and enhanced processing. |
box_ai_extract_structured_enhanced_using_template_tool | Extract structured data from files in Box using AI with a specified template and enhanced processing. |
box_ai_extract_structured_using_fields_tool | Extract structured data from files in Box using AI with specified fields. |
box_ai_extract_structured_using_template_tool | Extract structured data from files in Box using AI with a specified template. |
box_authorize_app_tool | Authorize the Box application. |
box_docgen_create_batch_tool | Create a new Box Doc Gen batch to generate documents from a template. |
box_docgen_create_single_file_from_user_input_tool | Create a single document from a Doc Gen template using user input. |
box_docgen_get_job_by_id_tool | Retrieve a Box Doc Gen job by its ID. |
box_docgen_list_jobs_by_batch_tool | List Doc Gen jobs in a specific batch. |
box_docgen_list_jobs_tool | List all Box Doc Gen jobs for the current user. |
box_docgen_template_create_tool | Mark a file as a Box Doc Gen template. |
box_docgen_template_get_by_id_tool | Retrieve details of a specific Box Doc Gen template. |
box_docgen_template_get_by_name_tool | Retrieve details of a specific Box Doc Gen template by name. |
box_docgen_template_list_jobs_tool | List Doc Gen jobs that used a specific template. |
box_docgen_template_list_tags_tool | List all tags for a Box Doc Gen template. |
box_docgen_template_list_tool | List all Box Doc Gen templates accessible to the user. |
box_download_file_tool | Download a file from Box and return its content as a string. |
box_list_folder_content_by_folder_id | List the content of a folder in Box by its ID. |
box_manage_folder_tool | Manage Box folders - create, delete, or update. |
box_metadata_delete_instance_on_file_tool | Delete a metadata instance on a file. |
box_metadata_get_instance_on_file_tool | Get a metadata instance on a file. |
box_metadata_set_instance_on_file_tool | Set a metadata instance on a file. |
box_metadata_template_create_tool | Create a metadata template. |
box_metadata_template_get_by_name_tool | Retrieve a metadata template by its name. |
box_metadata_update_instance_on_file_tool | Update a metadata instance on a file. |
box_read_tool | Read the text content of a file in Box. |
box_search_folder_by_name_tool | Locate a folder in Box by its name. |
box_search_tool | Search for files in Box with the given query. |
box_upload_file_from_content_tool | Upload content as a file to Box using the toolkit. |
box_upload_file_from_path_tool | Upload a file to Box from a filesystem path. |
box_who_am_i | Get the current user's information. |
mcp_server_info | Returns information about the MCP server. |
box_ai_ask_file_multi_tool
Ask Box AI about multiple files. This tool allows users to query Box AI with a specific prompt, leveraging the content of multiple files stored in Box. The AI processes the files and generates a response based on the provided prompt.
Parameters | Type | Description |
---|---|---|
file_ids | array | |
prompt | string | |
ai_agent_id | string optional |
box_ai_ask_file_single_tool
Ask Box AI about a single file. This tool allows users to query Box AI with a specific prompt, leveraging the content of a single file stored in Box. The AI processes the file and generates a response based on the provided prompt.
Parameters | Type | Description |
---|---|---|
file_id | string | |
prompt | string | |
ai_agent_id | string optional |
box_ai_ask_hub_tool
Ask Box AI about a specific hub. This tool allows users to query Box AI with a specific prompt, leveraging the content of a hub in Box. The AI processes the hub and generates a response based on the provided prompt.
Parameters | Type | Description |
---|---|---|
hubs_id | string | |
prompt | string | |
ai_agent_id | string optional |
box_ai_extract_freeform_tool
Extract data from files in Box using AI with a freeform prompt.
Parameters | Type | Description |
---|---|---|
file_ids | array | |
prompt | string | |
ai_agent_id | string optional |
box_ai_extract_structured_enhanced_using_fields_tool
Extract structured data from files in Box using AI with specified fields and enhanced processing. This tool allows users to extract structured data from files by specifying the fields they are interested in, with enhanced processing capabilities.
Parameters | Type | Description |
---|---|---|
fields | array | |
file_ids | array |
box_ai_extract_structured_enhanced_using_template_tool
Extract structured data from files in Box using AI with a specified template and enhanced processing. This tool allows users to extract structured data from files by using a predefined template, with enhanced processing capabilities.
Parameters | Type | Description |
---|---|---|
file_ids | array | |
template_key | string |
box_ai_extract_structured_using_fields_tool
Extract structured data from files in Box using AI with specified fields. This tool allows users to extract structured data from files by specifying the fields they are interested in. The AI processes the files and extracts the relevant information based on the provided fields.
Parameters | Type | Description |
---|---|---|
fields | array | |
file_ids | array | |
ai_agent_id | string optional |
box_ai_extract_structured_using_template_tool
Extract structured data from files in Box using AI with a specified template. This tool allows users to extract structured data from files by using a predefined template. The AI processes the files and extracts the relevant information based on the provided template.
Parameters | Type | Description |
---|---|---|
file_ids | array | |
template_key | string | |
ai_agent_id | string optional |
box_authorize_app_tool
Authorize the Box application. Start the Box app authorization process
return: str: Message
box_docgen_create_batch_tool
Create a new Box Doc Gen batch to generate documents from a template.
Parameters | Type | Description |
---|---|---|
destination_folder_id | string | |
docgen_template_id | string | |
document_generation_data | array | |
output_type | string optional |
box_docgen_create_single_file_from_user_input_tool
Create a single document from a Doc Gen template using user input.
Parameters | Type | Description |
---|---|---|
destination_folder_id | string | |
docgen_template_id | string | |
user_input | object | |
generated_file_name | string optional | |
output_type | string optional |
box_docgen_get_job_by_id_tool
Retrieve a Box Doc Gen job by its ID.
Parameters | Type | Description |
---|---|---|
job_id | string |
box_docgen_list_jobs_by_batch_tool
List Doc Gen jobs in a specific batch.
Parameters | Type | Description |
---|---|---|
batch_id | string | |
limit | string optional | |
marker | string optional |
box_docgen_list_jobs_tool
List all Box Doc Gen jobs for the current user.
Parameters | Type | Description |
---|---|---|
limit | string optional | |
marker | string optional |
box_docgen_template_create_tool
Mark a file as a Box Doc Gen template.
Parameters | Type | Description |
---|---|---|
file_id | string |
box_docgen_template_get_by_id_tool
Retrieve details of a specific Box Doc Gen template.
Parameters | Type | Description |
---|---|---|
template_id | string |
box_docgen_template_get_by_name_tool
Retrieve details of a specific Box Doc Gen template by name.
Parameters | Type | Description |
---|---|---|
template_name | string |
box_docgen_template_list_jobs_tool
List Doc Gen jobs that used a specific template.
Parameters | Type | Description |
---|---|---|
template_id | string | |
limit | string optional | |
marker | string optional |
box_docgen_template_list_tags_tool
List all tags for a Box Doc Gen template.
Parameters | Type | Description |
---|---|---|
template_id | string | |
limit | string optional | |
marker | string optional | |
template_version_id | string optional |
box_docgen_template_list_tool
List all Box Doc Gen templates accessible to the user.
Parameters | Type | Description |
---|---|---|
limit | string optional | |
marker | string optional |
box_download_file_tool
Download a file from Box and return its content as a string. Supports text files (returns content directly) and images (returns base64-encoded). Other file types will return an error message. Optionally saves the file locally.
Parameters | Type | Description |
---|---|---|
file_id | string | |
save_file | boolean optional | |
save_path | string optional |
box_list_folder_content_by_folder_id
List the content of a folder in Box by its ID.
Parameters | Type | Description |
---|---|---|
folder_id | string | |
is_recursive | boolean optional |
box_manage_folder_tool
Manage Box folders - create, delete, or update.
Parameters | Type | Description |
---|---|---|
action | string | |
description | string optional | |
folder_id | string optional | |
name | string optional | |
parent_id | string optional | |
recursive | boolean optional |
box_metadata_delete_instance_on_file_tool
Delete a metadata instance on a file.
Parameters | Type | Description |
---|---|---|
file_id | string | |
template_key | string |
box_metadata_get_instance_on_file_tool
Get a metadata instance on a file.
Parameters | Type | Description |
---|---|---|
file_id | string | |
template_key | string |
box_metadata_set_instance_on_file_tool
Set a metadata instance on a file.
Parameters | Type | Description |
---|---|---|
file_id | string | |
metadata | object | |
template_key | string |
box_metadata_template_create_tool
Create a metadata template.
Parameters | Type | Description |
---|---|---|
display_name | string | |
fields | array | |
template_key | string optional |
box_metadata_template_get_by_name_tool
Retrieve a metadata template by its name.
Parameters | Type | Description |
---|---|---|
template_name | string |
box_metadata_update_instance_on_file_tool
Update a metadata instance on a file.
Parameters | Type | Description |
---|---|---|
file_id | string | |
metadata | object | |
template_key | string | |
remove_non_included_data | boolean optional |
box_read_tool
Read the text content of a file in Box.
Parameters | Type | Description |
---|---|---|
file_id | string |
box_search_folder_by_name_tool
Locate a folder in Box by its name.
Parameters | Type | Description |
---|---|---|
folder_name | string |
box_search_tool
Search for files in Box with the given query.
Parameters | Type | Description |
---|---|---|
query | string | |
ancestor_folder_ids | string optional | |
file_extensions | string optional | |
where_to_look_for_query | string optional |
box_upload_file_from_content_tool
Upload content as a file to Box using the toolkit.
Parameters | Type | Description |
---|---|---|
content | string | |
file_name | string | |
folder_id | string optional | |
is_base64 | boolean optional |
box_upload_file_from_path_tool
Upload a file to Box from a filesystem path.
Parameters | Type | Description |
---|---|---|
file_path | string | |
folder_id | string optional | |
new_file_name | string optional |
box_who_am_i
Get the current user's information. This is also useful to check the connection status.
return: dict: The current user's information.
mcp_server_info
Returns information about the MCP server.
{
"mcpServers": {
"box": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"BOX_CLIENT_ID",
"-e",
"BOX_CLIENT_SECRET",
"mcp/box"
],
"env": {
"BOX_CLIENT_ID": "your_client_id",
"BOX_CLIENT_SECRET": "your_client_secret"
}
}
}
}
Manual installation
You can install the MCP server using:
Installation for