Skip to content
Scalekit Docs
Talk to an EngineerDashboard

Box MCP

Vendor MCP44 toolsOAuth 2.1Files & DocumentsProductivity

Connect to Box via MCP to manage files, folders, collaborations, users, groups, tasks, comments, and search content directly from your AI workflows.

Box MCP connector

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “Set your credentials”

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Set up the connector

    Section titled “Set up the connector”

    Register your Box MCP credentials with Scalekit so it handles the token lifecycle. You do this once per environment.

    Dashboard setup steps

    Register your Scalekit environment with Box MCP so Scalekit handles the OAuth flow and token lifecycle for your users. Create a Box OAuth application, then add its Client ID and Client Secret to your Scalekit connection.

    1. Copy the redirect URI from Scalekit

      • In the Scalekit dashboard, go to AgentKit > Connections > Create Connection. Find Box MCP and click Create.

      • Click Use your own credentials and copy the redirect URI. It looks like https://<SCALEKIT_ENVIRONMENT_URL>/sso/v1/oauth/<CONNECTION_ID>/callback.

    2. Create or open a Box OAuth app

      • Go to the Box Developer Console and click Platform Apps in the sidebar.

      • Click New App to create one, or open an existing app that uses OAuth 2.0 authentication.

        Box Platform Apps list showing an app configured with OAuth 2.0 authentication

    3. Add the redirect URI

      • Open the app’s Configuration tab.
      • Under OAuth 2.0 Redirect URIs, paste the redirect URI you copied from Scalekit and click Save.

    4. Copy your Client ID and Client Secret

      • In the App Details panel, copy the Client ID.

      • Click Copy next to Client Secret to copy it.

        Box App Details panel showing the Client ID and Client Secret fields

    5. Add credentials in Scalekit

      • Return to the connection you created in Scalekit and enter:
        • Client ID — from your Box app
        • Client Secret — from your Box app
      • Click Save.

  4. Authorize and make your first call

    Section titled “Authorize and make your first call”
    quickstart.ts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENV_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'boxmcp'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Box MCP:', link)
    process.stdout.write('Press Enter after authorizing...')
    await new Promise(r => process.stdin.once('data', r))
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'boxmcp_list_hubs',
      toolInput: {},
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • I who am — Returns detailed information about the currently authenticated Box user, including user profile data, identification, contact information, role details, and account settings
  • Version upload file — Uploads a new version of an existing Box file by replacing its content with the provided text
  • File upload, move, copy — Uploads a new text file to Box
  • Update metadata template, hub, folder properties — Updates a metadata template schema (add, edit, remove, or reorder fields, enum options, or multiSelect options; or rename the template)
  • Metadata set folder, set file — Creates or updates a metadata template instance on a Box folder (applies the template the first time, or updates it if already applied)
  • Search folders by name, files metadata, files keyword — Searches for folders by name within Box using keyword matching

Tool list

Section titled “Tool list”

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

boxmcp_add_items_to_hub#Adds files or folders to an existing Box Hub.2 params

Adds files or folders to an existing Box Hub.

NameTypeRequiredDescription
hub_idstringrequiredThe unique identifier of the Box Hub to add items to.
itemsarrayrequiredA list of items (files or folders) to add to the hub. Each item must include an 'id' and a 'type'.
boxmcp_ai_extract_freeform#Extracts data from one or more Box files using a freeform AI prompt. Supports analyzing multiple files simultaneously for comparative extraction. Returns unstructured extracted information based on the prompt.2 params

Extracts data from one or more Box files using a freeform AI prompt. Supports analyzing multiple files simultaneously for comparative extraction. Returns unstructured extracted information based on the prompt.

NameTypeRequiredDescription
file_idsarrayrequiredThe IDs of the Box files to extract data from.
promptstringrequiredA freeform prompt describing what data to extract.
boxmcp_ai_extract_structured_from_fields#Extracts structured data from one or more Box files using AI based on specified field definitions. Supports multi-file extraction for comparative analysis. Returns structured key-value pairs.2 params

Extracts structured data from one or more Box files using AI based on specified field definitions. Supports multi-file extraction for comparative analysis. Returns structured key-value pairs.

NameTypeRequiredDescription
fieldsarrayrequiredField definitions specifying what structured data to extract.
file_idsarrayrequiredThe IDs of the Box files to extract structured data from.
boxmcp_ai_extract_structured_from_fields_enhanced#Enhanced version of AI structured extraction from fields, using Box AI's Enhanced Extract Agent for improved extraction quality. Extracts structured data from one or more Box files based on specified field definitions. More expensive than the standard tool - use only when the user explicitly requests enhanced extraction.2 params

Enhanced version of AI structured extraction from fields, using Box AI's Enhanced Extract Agent for improved extraction quality. Extracts structured data from one or more Box files based on specified field definitions. More expensive than the standard tool - use only when the user explicitly requests enhanced extraction.

NameTypeRequiredDescription
fieldsarrayrequiredField definitions specifying what structured data to extract.
file_idsarrayrequiredThe IDs of the Box files to extract structured data from.
boxmcp_ai_extract_structured_from_metadata_template#Extracts structured data from one or more Box files using AI based on an existing metadata template schema. Both the template key and the template's scope are required to identify the template.3 params

Extracts structured data from one or more Box files using AI based on an existing metadata template schema. Both the template key and the template's scope are required to identify the template.

NameTypeRequiredDescription
file_idsarrayrequiredThe IDs of the Box files to extract data from.
scopestringrequiredThe scope of the metadata template.
template_keystringrequiredThe key of the metadata template to use for structured extraction.
boxmcp_ai_extract_structured_from_metadata_template_enhanced#Enhanced version of AI structured extraction using a metadata template, using Box AI's Enhanced Extract Agent for improved extraction quality. Extracts data from one or more Box files based on an existing metadata template. Both the template key and the template's scope are required. More expensive than the standard tool - use only when the user explicitly requests enhanced extraction.3 params

Enhanced version of AI structured extraction using a metadata template, using Box AI's Enhanced Extract Agent for improved extraction quality. Extracts data from one or more Box files based on an existing metadata template. Both the template key and the template's scope are required. More expensive than the standard tool - use only when the user explicitly requests enhanced extraction.

NameTypeRequiredDescription
file_idsarrayrequiredThe IDs of the Box files to extract data from.
scopestringrequiredThe scope of the metadata template.
template_keystringrequiredThe key of the metadata template to use for structured extraction.
boxmcp_ai_qa_hub#Asks a question about the content of a Box Hub using Box AI. Returns an AI-generated answer based on the hub's content, including citations to the source content when available.2 params

Asks a question about the content of a Box Hub using Box AI. Returns an AI-generated answer based on the hub's content, including citations to the source content when available.

NameTypeRequiredDescription
hub_idstringrequiredThe unique identifier of the Box Hub to query with AI.
questionstringrequiredThe question to ask Box AI about the hub's content.
boxmcp_ai_qa_multi_file#Asks a question across multiple Box files using Box AI. Returns an AI-generated answer synthesized from all provided files, including citations to the source content when available.2 params

Asks a question across multiple Box files using Box AI. Returns an AI-generated answer synthesized from all provided files, including citations to the source content when available.

NameTypeRequiredDescription
file_idsarrayrequiredThe IDs of the Box files to ask a question about.
questionstringrequiredThe question to ask Box AI about the files.
boxmcp_ai_qa_single_file#Asks a question about a single Box file using Box AI. Returns an AI-generated answer based on the file's content, including citations to the source content when available.2 params

Asks a question about a single Box file using Box AI. Returns an AI-generated answer based on the file's content, including citations to the source content when available.

NameTypeRequiredDescription
file_idstringrequiredThe ID of the Box file to ask a question about.
questionstringrequiredThe question to ask Box AI about the file.
boxmcp_copy_file#Creates a copy of a Box file in a destination folder. The source file is not modified. If no destination folder is provided, the copy is placed in the user's root folder. Optionally provide a new name for the copy; otherwise the original file name is used.3 params

Creates a copy of a Box file in a destination folder. The source file is not modified. If no destination folder is provided, the copy is placed in the user's root folder. Optionally provide a new name for the copy; otherwise the original file name is used.

NameTypeRequiredDescription
file_idstringrequiredThe ID of the Box file to copy.
namestringoptionalThe new name for the copied file. Defaults to the original name if not provided.
parent_folder_idstringoptionalThe ID of the destination folder for the copied file. Defaults to "0" (the user's root folder).
boxmcp_copy_folder#Creates a copy of a Box folder and all its contents in a destination folder. The source folder is not modified. The root folder (folder_id "0") cannot be copied. If no destination folder is provided, the copy is placed in the user's root folder. Optionally provide a new name for the copy; otherwise the original folder name is used.3 params

Creates a copy of a Box folder and all its contents in a destination folder. The source folder is not modified. The root folder (folder_id "0") cannot be copied. If no destination folder is provided, the copy is placed in the user's root folder. Optionally provide a new name for the copy; otherwise the original folder name is used.

NameTypeRequiredDescription
folder_idstringrequiredThe ID of the Box folder to copy.
namestringoptionalThe new name for the copied folder. Defaults to the original name if not provided.
parent_folder_idstringoptionalThe ID of the destination folder where the copy will be placed. Defaults to "0" (the user's root folder).
boxmcp_copy_hub#Creates a copy of an existing Box Hub via the Hubs v3 API. The source hub is not modified. The copy includes the source hub's shareable items and, unless overridden, its description. Only items the requesting user has permission to share into the new hub are copied; items visible only through the hub itself (without share permission) are not copied.3 params

Creates a copy of an existing Box Hub via the Hubs v3 API. The source hub is not modified. The copy includes the source hub's shareable items and, unless overridden, its description. Only items the requesting user has permission to share into the new hub are copied; items visible only through the hub itself (without share permission) are not copied.

NameTypeRequiredDescription
hub_idstringrequiredThe unique identifier of the source Box Hub to copy.
descriptionstringoptionalOptional description for the new hub. When omitted, the source hub's description is copied to the new hub.
titlestringoptionalOptional title for the new hub. Up to 50 characters.
boxmcp_create_file_comment#Adds a comment to a Box file.2 params

Adds a comment to a Box file.

NameTypeRequiredDescription
file_idstringrequiredThe ID of the Box file to comment on.
messagestringrequiredThe text content of the comment.
boxmcp_create_folder#Creates a new folder in Box. If no parent folder is provided, the folder is created in the user's root directory.2 params

Creates a new folder in Box. If no parent folder is provided, the folder is created in the user's root directory.

NameTypeRequiredDescription
namestringrequiredThe name of the new folder (max 255 characters; no slashes, leading/trailing spaces, or dots). Must be unique within the parent folder.
parent_folder_idstringoptionalThe ID of the parent folder where the new folder will be created. Defaults to "0" (root directory).
boxmcp_create_hub#Creates a new Box Hub for organizing and sharing content around a specific topic, project, or team. Accepts a required title (up to 50 characters) and an optional description (up to 1000 characters) providing context about the hub's purpose and contents.2 params

Creates a new Box Hub for organizing and sharing content around a specific topic, project, or team. Accepts a required title (up to 50 characters) and an optional description (up to 1000 characters) providing context about the hub's purpose and contents.

NameTypeRequiredDescription
titlestringrequiredThe title of the new hub.
descriptionstringoptionalOptional description for the new hub providing context about its purpose and contents.
boxmcp_create_metadata_template#Creates a new enterprise metadata template in Box. scope must be "enterprise"; each field requires type, key, and display_name. Optionally set template_key, hidden, copy_instance_on_item_copy, and enum/multiSelect/taxonomy field options (with an optional color_id 0-7 for enum options).6 params

Creates a new enterprise metadata template in Box. scope must be "enterprise"; each field requires type, key, and display_name. Optionally set template_key, hidden, copy_instance_on_item_copy, and enum/multiSelect/taxonomy field options (with an optional color_id 0-7 for enum options).

NameTypeRequiredDescription
display_namestringrequiredThe human-readable name of the metadata template.
scopestringrequiredThe scope of the metadata template. Must be "enterprise" — apps cannot create global templates.
copy_instance_on_item_copybooleanoptionalWhether to copy metadata instances of this template when the file/folder they're attached to is copied.
fieldsarrayoptionalOrdered field definitions for the template (string, float, date, enum, multiSelect, or taxonomy).
hiddenbooleanoptionalWhether the metadata template is hidden from users in the Box UI.
template_keystringoptionalThe unique machine-readable key for the metadata template. Auto-generated from display_name if not provided.
boxmcp_get_file_content#Retrieves the text content of a Box file by its ID. Useful for reading documents, notes, and other text-based files.1 param

Retrieves the text content of a Box file by its ID. Useful for reading documents, notes, and other text-based files.

NameTypeRequiredDescription
file_idstringrequiredThe ID of the Box file to retrieve content from.
boxmcp_get_file_details#Retrieves detailed metadata about a specific Box file including name, size, timestamps, owner, and other properties.2 params

Retrieves detailed metadata about a specific Box file including name, size, timestamps, owner, and other properties.

NameTypeRequiredDescription
file_idstringrequiredThe ID of the Box file to retrieve details for.
fieldsarrayoptionalList of additional fields to include in the response.
boxmcp_get_file_preview#Displays an interactive preview widget for a Box file. Supports common document, image, and spreadsheet formats (e.g. pdf, doc, docx, ppt, pptx, xls, xlsx, png, jpg, csv, and more). PDFs use a direct download; other types use a generated representation. Not usable when the preview payload would exceed 3MB. For file metadata instead of a visual preview, use get_file_details. To read the content of a specific page after previewing, use get_preview_page.1 param

Displays an interactive preview widget for a Box file. Supports common document, image, and spreadsheet formats (e.g. pdf, doc, docx, ppt, pptx, xls, xlsx, png, jpg, csv, and more). PDFs use a direct download; other types use a generated representation. Not usable when the preview payload would exceed 3MB. For file metadata instead of a visual preview, use get_file_details. To read the content of a specific page after previewing, use get_preview_page.

NameTypeRequiredDescription
fileIdstringrequiredThe ID of the Box file to preview.
boxmcp_get_folder_details#Retrieves detailed metadata about a specific Box folder including name, size, timestamps, owner, and other properties.2 params

Retrieves detailed metadata about a specific Box folder including name, size, timestamps, owner, and other properties.

NameTypeRequiredDescription
folder_idstringrequiredThe ID of the Box folder to retrieve details for.
fieldsarrayoptionalList of additional fields to include in the response.
boxmcp_get_hub_details#Retrieves detailed information about a specific Box Hub including its name, description, and settings.1 param

Retrieves detailed information about a specific Box Hub including its name, description, and settings.

NameTypeRequiredDescription
hub_idstringrequiredThe unique identifier of the Box Hub to retrieve details for.
boxmcp_get_hub_items#Retrieves the items (files and folders) contained in a specific Box Hub.3 params

Retrieves the items (files and folders) contained in a specific Box Hub.

NameTypeRequiredDescription
hub_idstringrequiredThe unique identifier of the Box Hub whose items to retrieve.
limitintegeroptionalThe maximum number of items to return per page.
markerstringoptionalA pagination cursor returned from a previous call to continue listing from a specific position.
boxmcp_get_metadata_template_schema#Retrieves the schema definition for a specific metadata template in Box, including all field definitions, types, and options.2 params

Retrieves the schema definition for a specific metadata template in Box, including all field definitions, types, and options.

NameTypeRequiredDescription
scopestringrequiredThe scope of the metadata template.
template_keystringrequiredThe unique key identifying the metadata template.
boxmcp_get_preview_page#Returns a specific page of a Box file previewed with get_file_preview as an image, so its content (figures, text, charts, etc.) can be analyzed. Use the fileId and page number from the active file preview context.2 params

Returns a specific page of a Box file previewed with get_file_preview as an image, so its content (figures, text, charts, etc.) can be analyzed. Use the fileId and page number from the active file preview context.

NameTypeRequiredDescription
fileIdstringrequiredThe ID of the Box file whose preview page you want to retrieve.
pageintegerrequiredThe 1-based page number to return as a PNG image.
boxmcp_list_file_comments#Retrieves all comments associated with a specific Box file.4 params

Retrieves all comments associated with a specific Box file.

NameTypeRequiredDescription
file_idstringrequiredThe ID of the Box file to list comments for.
fieldsarrayoptionalList of fields to include in each comment in the response.
limitintegeroptionalMaximum number of comments to return.
offsetintegeroptionalThe offset of the comment at which to begin the response.
boxmcp_list_folder_content_by_folder_id#Lists files, folders, and web links contained in a folder. Returns a paginated list. Use folder_id "0" for the root folder.4 params

Lists files, folders, and web links contained in a folder. Returns a paginated list. Use folder_id "0" for the root folder.

NameTypeRequiredDescription
folder_idstringrequiredThe ID of the folder to list contents of. Use "0" for the root folder.
fieldsarrayoptionalList of fields to include in the response for each item.
limitintegeroptionalMaximum number of items to return.
offsetintegeroptionalThe offset of the item at which to begin the response.
boxmcp_list_hubs#Lists all Box Hubs accessible to the authenticated user. Box Hubs are curated collections of content.2 params

Lists all Box Hubs accessible to the authenticated user. Box Hubs are curated collections of content.

NameTypeRequiredDescription
limitintegeroptionalThe maximum number of hubs to return per page. Defaults to 100, maximum is 1000.
markerstringoptionalA pagination cursor returned from a previous call to continue listing from a specific position.
boxmcp_list_item_collaborations#Lists all collaborations (shared access) for up to 10 Box files and/or folders in a single request. Returns detailed collaboration information (user details, roles, status, timestamps) for each item, with partial-failure handling: collaborations for successful items are still returned even if some items in the batch fail to load.1 param

Lists all collaborations (shared access) for up to 10 Box files and/or folders in a single request. Returns detailed collaboration information (user details, roles, status, timestamps) for each item, with partial-failure handling: collaborations for successful items are still returned even if some items in the batch fail to load.

NameTypeRequiredDescription
itemsarrayrequiredArray of items (files and/or folders) to list collaborations for.
boxmcp_list_metadata_templates#Lists all metadata templates available in the Box enterprise or global scope.3 params

Lists all metadata templates available in the Box enterprise or global scope.

NameTypeRequiredDescription
scopestringrequiredThe scope of metadata templates to list: 'global' or 'enterprise'.
limitintegeroptionalMaximum number of metadata templates to return.
markerstringoptionalA pagination marker for fetching the next page of results.
boxmcp_list_tasks#Lists tasks assigned to the authenticated user or associated with a specific file in Box.1 param

Lists tasks assigned to the authenticated user or associated with a specific file in Box.

NameTypeRequiredDescription
file_idstringrequiredThe ID of the Box file to list tasks for.
boxmcp_move_file#Moves a Box file to a different folder. The file stays the same item (same ID); only its parent folder changes. A destination parent_folder_id is required. Optionally rename the file while moving by providing a new name.3 params

Moves a Box file to a different folder. The file stays the same item (same ID); only its parent folder changes. A destination parent_folder_id is required. Optionally rename the file while moving by providing a new name.

NameTypeRequiredDescription
file_idstringrequiredThe ID of the Box file to move.
parent_folder_idstringrequiredThe ID of the folder that will become the file's new parent. Use "0" for the user's root folder.
namestringoptionalThe new name for the file. Defaults to the original name if not provided.
boxmcp_move_folder#Moves a Box folder to a different parent folder. The folder keeps the same ID; only its parent changes. This is not for restoring items from trash. A destination parent_folder_id is required. Optionally rename the folder while moving by providing a new name.3 params

Moves a Box folder to a different parent folder. The folder keeps the same ID; only its parent changes. This is not for restoring items from trash. A destination parent_folder_id is required. Optionally rename the folder while moving by providing a new name.

NameTypeRequiredDescription
folder_idstringrequiredThe ID of the Box folder to move.
parent_folder_idstringrequiredThe ID of the folder that will become this folder's new parent. Use "0" for the user's root folder.
namestringoptionalThe new name for the folder. Defaults to the original name if not provided.
boxmcp_search_files_keyword#Searches for files using keywords with support for metadata filters (mdfilters), file extension filtering, date range filters (including deleted/trashed items), and field selection. Maps to Box's searchForContent API.9 params

Searches for files using keywords with support for metadata filters (mdfilters), file extension filtering, date range filters (including deleted/trashed items), and field selection. Maps to Box's searchForContent API.

NameTypeRequiredDescription
querystringrequiredThe keyword or phrase to search for in file names and content.
ancestor_folder_idstringoptionalID of a parent folder to scope the search within.
created_at_rangestringoptionalFilter files by creation date range (ISO 8601 range string).
deleted_at_rangestringoptionalFilter trashed files by deletion date range (ISO 8601 range string).
fieldsarrayoptionalList of fields to include in the response for each file.
file_extensionsarrayoptionalList of file extensions to filter results by.
limitintegeroptionalMaximum number of files to return.
mdfiltersarrayoptionalMetadata template filters to further narrow the search. Each entry specifies a template's scope and templateKey, plus field-level filter conditions (exact value, a list of values, or a {"gt": ..., "lt": ...} range).
updated_at_rangestringoptionalFilter files by last updated date range (ISO 8601 range string).
boxmcp_search_files_metadata#Searches for files using SQL-like metadata queries. Requires 'from' (e.g. enterprise_123456.templateKey from list_metadata_templates) and 'query' (a SQL-like filter using field keys from get_metadata_template_schema). ancestor_folder_id defaults to "0" (root) if omitted. Use list_metadata_templates and get_metadata_template_schema first to discover templates and field keys.6 params

Searches for files using SQL-like metadata queries. Requires 'from' (e.g. enterprise_123456.templateKey from list_metadata_templates) and 'query' (a SQL-like filter using field keys from get_metadata_template_schema). ancestor_folder_id defaults to "0" (root) if omitted. Use list_metadata_templates and get_metadata_template_schema first to discover templates and field keys.

NameTypeRequiredDescription
fromstringrequiredThe metadata template to search against in 'scope.templateKey' format.
querystringrequiredA SQL-like query to filter metadata fields.
ancestor_folder_idstringoptionalLimit search results to items in a specific folder. Defaults to "0" (root) if omitted.
fieldsarrayoptionalMetadata fields to return in the results.
limitintegeroptionalMaximum number of results to return (max 100).
query_paramsobjectoptionalParameters for the query placeholders.
boxmcp_search_folders_by_name#Searches for folders by name within Box using keyword matching. Can be scoped to search within a particular parent folder. Returns basic folder information including ID, type, and name. Supports optional comma-separated RFC3339 date range filters for folder creation, last update, and deletion timestamps (e.g. "2024-01-01T00:00:00Z,2024-12-31T23:59:59Z"; omit either side of the comma to leave that end of the range open).6 params

Searches for folders by name within Box using keyword matching. Can be scoped to search within a particular parent folder. Returns basic folder information including ID, type, and name. Supports optional comma-separated RFC3339 date range filters for folder creation, last update, and deletion timestamps (e.g. "2024-01-01T00:00:00Z,2024-12-31T23:59:59Z"; omit either side of the comma to leave that end of the range open).

NameTypeRequiredDescription
folder_namestringrequiredThe name or keyword to search for in folder names.
ancestor_folder_idstringoptionalID of a parent folder to scope the search within.
created_at_rangestringoptionalFilter folders by creation date range (comma-separated RFC3339 timestamps).
deleted_at_rangestringoptionalFilter folders by deletion date range (comma-separated RFC3339 timestamps).
limitintegeroptionalMaximum number of folders to return.
updated_at_rangestringoptionalFilter folders by last updated date range (comma-separated RFC3339 timestamps).
boxmcp_set_file_metadata#Creates or updates a metadata template instance on a Box file (applies the template the first time, or updates it if already applied). Use list_metadata_templates and get_metadata_template_schema first to determine the correct scope, template_key, and field keys for metadata_fields.4 params

Creates or updates a metadata template instance on a Box file (applies the template the first time, or updates it if already applied). Use list_metadata_templates and get_metadata_template_schema first to determine the correct scope, template_key, and field keys for metadata_fields.

NameTypeRequiredDescription
file_idstringrequiredThe ID of the Box file to attach or update metadata on.
metadata_fieldsobjectrequiredField keys and values for this template. Use get_metadata_template_schema for valid field keys.
scopestringrequiredThe scope of the metadata template. Either 'enterprise' or 'global'.
template_keystringrequiredThe key of the metadata template to use.
boxmcp_set_folder_metadata#Creates or updates a metadata template instance on a Box folder (applies the template the first time, or updates it if already applied). Does not apply to the root folder (ID "0"). Use list_metadata_templates and get_metadata_template_schema first to determine the correct scope, template_key, and field keys for metadata_fields.4 params

Creates or updates a metadata template instance on a Box folder (applies the template the first time, or updates it if already applied). Does not apply to the root folder (ID "0"). Use list_metadata_templates and get_metadata_template_schema first to determine the correct scope, template_key, and field keys for metadata_fields.

NameTypeRequiredDescription
folder_idstringrequiredThe ID of the Box folder to attach or update metadata on. Root folder "0" is not supported.
metadata_fieldsobjectrequiredField keys and values for this template. Use get_metadata_template_schema for valid field keys.
scopestringrequiredThe scope of the metadata template. Either 'enterprise' or 'global'.
template_keystringrequiredThe key of the metadata template to use.
boxmcp_update_file_properties#Updates file metadata: name, description, tags, and collections. When renaming, always preserve the original file extension unless explicitly instructed to change it.5 params

Updates file metadata: name, description, tags, and collections. When renaming, always preserve the original file extension unless explicitly instructed to change it.

NameTypeRequiredDescription
file_idstringrequiredThe unique identifier of the file to update.
collectionsarrayoptionalArray of collection objects with IDs to add the file to.
descriptionstringoptionalNew description for the file.
namestringoptionalNew name for the file (including extension).
tagsarrayoptionalArray of tags to apply to the file.
boxmcp_update_folder_properties#Updates folder metadata: name, description, tags, and collections.5 params

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

NameTypeRequiredDescription
folder_idstringrequiredThe unique identifier of the folder to update.
collectionsarrayoptionalArray of collection objects with IDs to add the folder to.
descriptionstringoptionalNew description for the folder.
namestringoptionalNew name for the folder (max 255 chars, no / \ . .. or leading/trailing spaces).
tagsarrayoptionalArray of tags to apply to the folder.
boxmcp_update_hub#Updates the title or description of a specific Box Hub. You can update one or more properties by providing the hub ID and the fields you want to change; only the fields you specify are updated, others remain unchanged.3 params

Updates the title or description of a specific Box Hub. You can update one or more properties by providing the hub ID and the fields you want to change; only the fields you specify are updated, others remain unchanged.

NameTypeRequiredDescription
hub_idstringrequiredThe unique numeric identifier of the hub to update.
descriptionstringoptionalNew description for the hub. Leave empty to keep the existing description.
titlestringoptionalNew title for the hub. Leave empty to keep the existing title.
boxmcp_update_metadata_template#Updates a metadata template schema (add, edit, remove, or reorder fields, enum options, or multiSelect options; or rename the template). Use scope and template_key from list_metadata_templates or get_metadata_template_schema. Each operation needs an 'op'; use camelCase in data per the Box API. For Shield classifications (template_key "securityClassification-6VMVochwUWo"), set the color via data.staticConfig.classification.colorID (0=Yellow, 1=Orange, 2=Red, 3=Purple, 4=LightBlue, 5=DarkBlue, 6=Green, 7=Grey).3 params

Updates a metadata template schema (add, edit, remove, or reorder fields, enum options, or multiSelect options; or rename the template). Use scope and template_key from list_metadata_templates or get_metadata_template_schema. Each operation needs an 'op'; use camelCase in data per the Box API. For Shield classifications (template_key "securityClassification-6VMVochwUWo"), set the color via data.staticConfig.classification.colorID (0=Yellow, 1=Orange, 2=Red, 3=Purple, 4=LightBlue, 5=DarkBlue, 6=Green, 7=Grey).

NameTypeRequiredDescription
operationsarrayrequiredA list of operations to perform on the metadata template, such as adding, editing, or reordering fields, enum options, or multiSelect options.
scopestringrequiredThe scope of the metadata template. Either 'enterprise' or 'global'.
template_keystringrequiredThe unique key of the metadata template to update.
boxmcp_upload_file#Uploads a new text file to Box. Provide the file name (including its extension) and the text content to upload; a parent folder ID can optionally be provided to place the file, defaulting to the root folder ("0") if omitted. Fails if a file with the same name already exists in the target folder. Supports text-based file types only (txt, md, boxnote, html, svg, xml, csv, json, js, ts, py, sh) — use get_upload_url to upload binary files.3 params

Uploads a new text file to Box. Provide the file name (including its extension) and the text content to upload; a parent folder ID can optionally be provided to place the file, defaulting to the root folder ("0") if omitted. Fails if a file with the same name already exists in the target folder. Supports text-based file types only (txt, md, boxnote, html, svg, xml, csv, json, js, ts, py, sh) — use get_upload_url to upload binary files.

NameTypeRequiredDescription
file_contentstringrequiredThe file content as text.
file_namestringrequiredThe name to give the uploaded file, including its extension.
parent_folder_idstringoptionalThe ID of the destination Box folder to upload the file into. Defaults to "0" (the user's root folder).
boxmcp_upload_file_version#Uploads a new version of an existing Box file by replacing its content with the provided text. The file ID must correspond to an existing file, otherwise an error is returned. Supports text content only — use get_upload_url to upload binary files.2 params

Uploads a new version of an existing Box file by replacing its content with the provided text. The file ID must correspond to an existing file, otherwise an error is returned. Supports text content only — use get_upload_url to upload binary files.

NameTypeRequiredDescription
file_contentstringrequiredThe new file content as text.
file_idstringrequiredThe ID of the existing Box file to upload a new version for.
boxmcp_who_am_i#Returns detailed information about the currently authenticated Box user, including user profile data, identification, contact information, role details, and account settings. No input parameters required.0 params

Returns detailed information about the currently authenticated Box user, including user profile data, identification, contact information, role details, and account settings. No input parameters required.