Box

Box

An MCP server capable of interacting with the Box API.

2.3K

2

36 Tools

Signed
Built by Docker
Requires Configuration
Requires Secrets
Add to Docker Desktop

Version 4.43 or later needs to be installed to add the server automatically

Use cases

About

Box MCP Server

An MCP server capable of interacting with the Box API.

What is an MCP Server?

Characteristics

AttributeDetails
Docker Imagemcp/box
Authorbox-community
Repositoryhttps://github.com/box-community/mcp-server-box
Dockerfilehttps://github.com/box-community/mcp-server-box/blob/refs/pull/4/merge/Dockerfile
Docker Image built byDocker Inc.
Docker Scout Health ScoreDocker Scout Health Score
Verify SignatureCOSIGN_REPOSITORY=mcp/signatures cosign verify mcp/box --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub
Licence

Available Tools (36)

Tools provided by this ServerShort Description
box_ai_ask_file_multi_toolAsk Box AI about multiple files.
box_ai_ask_file_single_toolAsk Box AI about a single file.
box_ai_ask_hub_toolAsk Box AI about a specific hub.
box_ai_extract_freeform_toolExtract data from files in Box using AI with a freeform prompt.
box_ai_extract_structured_enhanced_using_fields_toolExtract structured data from files in Box using AI with specified fields and enhanced processing.
box_ai_extract_structured_enhanced_using_template_toolExtract structured data from files in Box using AI with a specified template and enhanced processing.
box_ai_extract_structured_using_fields_toolExtract structured data from files in Box using AI with specified fields.
box_ai_extract_structured_using_template_toolExtract structured data from files in Box using AI with a specified template.
box_authorize_app_toolAuthorize the Box application.
box_docgen_create_batch_toolCreate a new Box Doc Gen batch to generate documents from a template.
box_docgen_create_single_file_from_user_input_toolCreate a single document from a Doc Gen template using user input.
box_docgen_get_job_by_id_toolRetrieve a Box Doc Gen job by its ID.
box_docgen_list_jobs_by_batch_toolList Doc Gen jobs in a specific batch.
box_docgen_list_jobs_toolList all Box Doc Gen jobs for the current user.
box_docgen_template_create_toolMark a file as a Box Doc Gen template.
box_docgen_template_get_by_id_toolRetrieve details of a specific Box Doc Gen template.
box_docgen_template_get_by_name_toolRetrieve details of a specific Box Doc Gen template by name.
box_docgen_template_list_jobs_toolList Doc Gen jobs that used a specific template.
box_docgen_template_list_tags_toolList all tags for a Box Doc Gen template.
box_docgen_template_list_toolList all Box Doc Gen templates accessible to the user.
box_download_file_toolDownload a file from Box and return its content as a string.
box_list_folder_content_by_folder_idList the content of a folder in Box by its ID.
box_manage_folder_toolManage Box folders - create, delete, or update.
box_metadata_delete_instance_on_file_toolDelete a metadata instance on a file.
box_metadata_get_instance_on_file_toolGet a metadata instance on a file.
box_metadata_set_instance_on_file_toolSet a metadata instance on a file.
box_metadata_template_create_toolCreate a metadata template.
box_metadata_template_get_by_name_toolRetrieve a metadata template by its name.
box_metadata_update_instance_on_file_toolUpdate a metadata instance on a file.
box_read_toolRead the text content of a file in Box.
box_search_folder_by_name_toolLocate a folder in Box by its name.
box_search_toolSearch for files in Box with the given query.
box_upload_file_from_content_toolUpload content as a file to Box using the toolkit.
box_upload_file_from_path_toolUpload a file to Box from a filesystem path.
box_who_am_iGet the current user's information.
mcp_server_infoReturns information about the MCP server.

Tools Details

Tool: 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.

ParametersTypeDescription
file_idsarray
promptstring
ai_agent_idstringoptional

Tool: 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.

ParametersTypeDescription
file_idstring
promptstring
ai_agent_idstringoptional

Tool: 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.

ParametersTypeDescription
hubs_idstring
promptstring
ai_agent_idstringoptional

Tool: box_ai_extract_freeform_tool

Extract data from files in Box using AI with a freeform prompt.

ParametersTypeDescription
file_idsarray
promptstring
ai_agent_idstringoptional

Tool: 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.

ParametersTypeDescription
fieldsarray
file_idsarray

Tool: 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.

ParametersTypeDescription
file_idsarray
template_keystring

Tool: 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.

ParametersTypeDescription
fieldsarray
file_idsarray
ai_agent_idstringoptional

Tool: 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.

ParametersTypeDescription
file_idsarray
template_keystring
ai_agent_idstringoptional

Tool: box_authorize_app_tool

Authorize the Box application. Start the Box app authorization process

return: str: Message

Tool: box_docgen_create_batch_tool

Create a new Box Doc Gen batch to generate documents from a template.

ParametersTypeDescription
destination_folder_idstring
docgen_template_idstring
document_generation_dataarray
output_typestringoptional

Tool: box_docgen_create_single_file_from_user_input_tool

Create a single document from a Doc Gen template using user input.

ParametersTypeDescription
destination_folder_idstring
docgen_template_idstring
user_inputobject
generated_file_namestringoptional
output_typestringoptional

Tool: box_docgen_get_job_by_id_tool

Retrieve a Box Doc Gen job by its ID.

ParametersTypeDescription
job_idstring

Tool: box_docgen_list_jobs_by_batch_tool

List Doc Gen jobs in a specific batch.

ParametersTypeDescription
batch_idstring
limitstringoptional
markerstringoptional

Tool: box_docgen_list_jobs_tool

List all Box Doc Gen jobs for the current user.

ParametersTypeDescription
limitstringoptional
markerstringoptional

Tool: box_docgen_template_create_tool

Mark a file as a Box Doc Gen template.

ParametersTypeDescription
file_idstring

Tool: box_docgen_template_get_by_id_tool

Retrieve details of a specific Box Doc Gen template.

ParametersTypeDescription
template_idstring

Tool: box_docgen_template_get_by_name_tool

Retrieve details of a specific Box Doc Gen template by name.

ParametersTypeDescription
template_namestring

Tool: box_docgen_template_list_jobs_tool

List Doc Gen jobs that used a specific template.

ParametersTypeDescription
template_idstring
limitstringoptional
markerstringoptional

Tool: box_docgen_template_list_tags_tool

List all tags for a Box Doc Gen template.

ParametersTypeDescription
template_idstring
limitstringoptional
markerstringoptional
template_version_idstringoptional

Tool: box_docgen_template_list_tool

List all Box Doc Gen templates accessible to the user.

ParametersTypeDescription
limitstringoptional
markerstringoptional

Tool: 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.

ParametersTypeDescription
file_idstring
save_filebooleanoptional
save_pathstringoptional

Tool: box_list_folder_content_by_folder_id

List the content of a folder in Box by its ID.

ParametersTypeDescription
folder_idstring
is_recursivebooleanoptional

Tool: box_manage_folder_tool

Manage Box folders - create, delete, or update.

ParametersTypeDescription
actionstring
descriptionstringoptional
folder_idstringoptional
namestringoptional
parent_idstringoptional
recursivebooleanoptional

Tool: box_metadata_delete_instance_on_file_tool

Delete a metadata instance on a file.

ParametersTypeDescription
file_idstring
template_keystring

Tool: box_metadata_get_instance_on_file_tool

Get a metadata instance on a file.

ParametersTypeDescription
file_idstring
template_keystring

Tool: box_metadata_set_instance_on_file_tool

Set a metadata instance on a file.

ParametersTypeDescription
file_idstring
metadataobject
template_keystring

Tool: box_metadata_template_create_tool

Create a metadata template.

ParametersTypeDescription
display_namestring
fieldsarray
template_keystringoptional

Tool: box_metadata_template_get_by_name_tool

Retrieve a metadata template by its name.

ParametersTypeDescription
template_namestring

Tool: box_metadata_update_instance_on_file_tool

Update a metadata instance on a file.

ParametersTypeDescription
file_idstring
metadataobject
template_keystring
remove_non_included_databooleanoptional

Tool: box_read_tool

Read the text content of a file in Box.

ParametersTypeDescription
file_idstring

Tool: box_search_folder_by_name_tool

Locate a folder in Box by its name.

ParametersTypeDescription
folder_namestring

Tool: box_search_tool

Search for files in Box with the given query.

ParametersTypeDescription
querystring
ancestor_folder_idsstringoptional
file_extensionsstringoptional
where_to_look_for_querystringoptional

Tool: box_upload_file_from_content_tool

Upload content as a file to Box using the toolkit.

ParametersTypeDescription
contentstring
file_namestring
folder_idstringoptional
is_base64booleanoptional

Tool: box_upload_file_from_path_tool

Upload a file to Box from a filesystem path.

ParametersTypeDescription
file_pathstring
folder_idstringoptional
new_file_namestringoptional

Tool: 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.

Tool: mcp_server_info

Returns information about the MCP server.

Use this 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"
      }
    }
  }
}

Why is it safer to run MCP Servers with Docker?

Manual installation

You can install the MCP server using:

Installation for

Related servers