// MCP TOOL REFERENCE

BOX TOOLS

93 tools from the Box MCP Server, categorised by risk level.

// ALL 93 BOX TOOLS

READ 43 tools

Read box_ai_ask_file_multi_tool Ask Box AI a question about multiple files Read box_ai_ask_file_single_tool Ask Box AI a question about a single file Read box_ai_ask_hub_tool Ask Box AI a question about a Box hub Read box_ai_extract_freeform_tool Extract information from files using natural language Read box_ai_extract_structured_enhanced_using_fields_tool Enhanced field-based extraction for complex documents Read box_ai_extract_structured_using_fields_tool Extract structured data using custom fields Read box_ai_extract_structured_using_template_tool Extract structured data using a metadata template Read box_collaboration_list_by_file_tool List all collaborations on a file Read box_collaboration_list_by_folder_tool List all collaborations on a folder Read box_docgen_get_job_by_id_tool Retrieve a DocGen job by ID Read box_docgen_list_jobs_by_batch_tool List DocGen jobs in a batch Read box_docgen_template_get_by_id_tool Retrieve a DocGen template by ID Read box_docgen_template_get_by_name_tool Retrieve a DocGen template by name Read box_docgen_template_list_jobs_tool List jobs for a DocGen template Read box_docgen_template_list_tags_tool List tags/variables for a DocGen template Read box_docgen_template_list_tool List all DocGen templates Read box_file_info_tool Get detailed information about a file Read box_folder_info_tool Retrieve detailed information about a folder Read box_folder_items_list_tool List items in a folder with optional recursion Read box_folder_list_tags_tool List tags associated with a folder Read box_groups_list_by_user_tool List all groups a user belongs to Read box_groups_list_members_tool List all members of a group Read box_groups_search_tool Search for groups by name Read box_metadata_get_instance_on_file_tool Get metadata instance on a file Read box_metadata_template_get_by_key_tool Retrieve a metadata template by key Read box_metadata_template_get_by_name_tool Retrieve a metadata template by name Read box_metadata_template_list_tool List all metadata templates Read box_search_folder_by_name_tool Locate a folder by its name Read box_search_tool Search for files and folders in Box Read box_shared_link_file_find_by_shared_link_url_tool Find a file by its shared link URL Read box_shared_link_file_get_tool Get a shared link for a file Read box_shared_link_folder_find_by_shared_link_url_tool Find a folder by its shared link URL Read box_shared_link_folder_get_tool Get a shared link for a folder Read box_task_assignment_details_tool Get details of a task assignment Read box_task_assignments_list_tool List all assignments for a task Read box_task_details_tool Get details of a task Read box_task_file_list_tool List all tasks for a file Read box_users_list_tool List all users in the Box account Read box_users_locate_by_email_tool Find a user by email address Read box_users_locate_by_name_tool Find a user by exact full name Read box_users_search_by_name_or_email_tool Search users by partial name or email Read box_web_link_get_by_id_tool Get a web link by its ID Read box_who_am_i Get information about the current authenticated user

WRITE 40 tools

Write box_collaboration_file_group_by_group_id_tool Create file collaboration with a group Write box_collaboration_file_user_by_user_id_tool Create file collaboration with a user by ID Write box_collaboration_file_user_by_user_login_tool Create file collaboration with a user by email Write box_collaboration_folder_group_by_group_id_tool Create folder collaboration with a group Write box_collaboration_folder_user_by_user_id_tool Create folder collaboration with a user by ID Write box_collaboration_update_tool Update a collaboration role or settings Write box_docgen_create_batch_tool Create a batch of documents from a template Write box_docgen_create_single_file_from_user_input_tool Create a document from user input and template Write box_docgen_template_create_tool Mark a file as a DocGen template Write box_file_copy_tool Create a copy of a file Write box_file_lock_tool Lock a file to prevent modifications Write box_file_move_tool Move a file to a different folder Write box_file_rename_tool Rename a file Write box_file_retention_date_clear_tool Clear retention date from a file Write box_file_retention_date_set_tool Set a retention date on a file Write box_file_set_description_tool Set or update a file description Write box_file_unlock_tool Remove a lock from a file Write box_folder_copy_tool Copy a folder to a new location Write box_folder_create_tool Create a new folder Write box_folder_favorites_add_tool Add a folder to favourites Write box_folder_favorites_remove_tool Remove a folder from favourites Write box_folder_move_tool Move a folder to a new location Write box_folder_rename_tool Rename a folder Write box_folder_set_collaboration_tool Set collaboration settings for a folder Write box_folder_set_description_tool Set the description for a folder Write box_folder_tag_add_tool Add a tag to a folder Write box_folder_tag_remove_tool Remove a tag from a folder Write box_metadata_set_instance_on_file_tool Set metadata instance on a file Write box_metadata_template_create_tool Create a new metadata template Write box_metadata_update_instance_on_file_tool Update metadata instance on a file Write box_shared_link_file_create_or_update_tool Create or update a shared link for a file Write box_shared_link_folder_create_or_update_tool Create or update a shared link for a folder Write box_shared_link_web_link_create_or_update_tool Create or update a shared link for a web link Write box_task_assign_by_email_tool Assign a task to a user via email Write box_task_assign_by_user_id_tool Assign a task to a user via user ID Write box_task_complete_create_tool Create a completion task for a file Write box_task_review_create_tool Create a review task for a file Write box_task_update_tool Update a task Write box_web_link_create_tool Create a web link in Box Write box_web_link_update_by_id_tool Update a web link

DESTRUCTIVE 9 tools

Destructive box_collaboration_delete_tool Remove a collaboration from a file or folder Destructive box_docgen_template_delete_tool Remove a file as a DocGen template Destructive box_file_delete_tool Permanently delete a file Destructive box_folder_delete_tool Permanently delete a folder and all contents Destructive box_metadata_delete_instance_on_file_tool Delete metadata instance from a file Destructive box_shared_link_file_remove_tool Remove a shared link from a file Destructive box_shared_link_folder_remove_tool Remove a shared link from a folder Destructive box_task_remove_tool Remove a task from a file Destructive box_web_link_delete_by_id_tool Delete a web link

EXECUTE 1 tools

Execute box_authorize_app_tool Start the Box OAuth authorisation process

// RUNNING THIS SERVER

The managed route: connect Box through the PolicyLayer gateway — every tool call above is checked against your policy before it runs, with a full audit log.

DIRECT INSTALL (UNMANAGED) npx -y @box-community/mcp-server-box

// FAQ

How many tools does the Box MCP server have? +

The Box MCP server exposes 93 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on Box tools? +

Route the Box server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard — they are enforced on every call before it reaches the server.

What risk categories do Box tools fall into? +

Box tools are categorised as Read (43), Write (40), Destructive (9), Execute (1). Each category has a recommended default policy.

Let agents act without letting them run wild.

Route your MCP servers through PolicyLayer and every tool call is checked against your policy before it runs — allow, deny, or require approval. Per-identity grants. Full audit log. Live in minutes.

SECURE YOUR MCP →

Free to start. No card required.

4,600+ MCP servers and 31,000+ tools scanned and risk-classified.