Box MCP connector

Box is a cloud content management platform for storing, sharing, and collaborating on files and folders. The Box MCP connector allows AI agents to manage authentication and access tokens while handling file operations such as retrieving, updating, restoring, and deleting content. It also supports downloading files, tracking file associations, and organizing content across folders within a Box account.

Authentication type

• OAuth 2.0 Authorization Code - Requires a one-time user login to authorize the agent to access the service on their behalf.

Uses

Use the Box MCP connector to perform the following actions:

• Upload, download, and organize files across shared team folders
• Automate approval workflows using file tasks and comments
• Restore deleted files and previous versions without manual searching
• Track file collaborations and permissions across departments
• Sync large files reliably using chunked upload sessions
• Retrieve file metadata to power custom business reporting
• Maintain accurate audit trails with file version history
• Authenticate workflows securely using OAuth 2.0 token exchange

Example prompts

Use the following example prompts to invoke Box MCP connector tools from your AI assistant or Boomi Connect workflow:

• Show me all files uploaded to Box last week.
• Download the latest version of the marketing budget file from Box.
• Restore the presentation I accidentally deleted from Box.
• Who has access to the client contract stored in Box.
• Upload this large video file to Box using an upload session.
• List all comments on the proposal document in Box.
• Find previous versions of the financial report in Box.
• Delete the outdated draft file from Box.
• Show me pending tasks assigned to me in Box.
• Get a thumbnail preview of the product image in Box.

Box MCP connector tools

The Box MCP connector provides the following tools. Each tool maps to a specific action you can invoke from your AI agent or automation.

Tool	Description
get_authorize	Authorize user
post_oauth2_token	Request access token
post_oauth2_token_refresh	Refresh access token
post_oauth2_revoke	Revoke access token
get_files_id	Get file information
post_files_id	Restore file
put_files_id	Update file
delete_files_id	Delete file
get_files_id_app_item_associations	List file app item associations
get_files_id_content	Download file
options_files_content	Preflight check before upload
post_files_upload_sessions	Create upload session
post_files_id_upload_sessions	Create upload session for existing file
get_files_upload_sessions_id	Get upload session
delete_files_upload_sessions_id	Remove upload session
get_files_upload_sessions_id_parts	List parts
post_files_upload_sessions_id_commit	Commit upload session
post_files_id_copy	Copy file
get_files_id_thumbnail_id	Get file thumbnail
get_files_id_collaborations	List file collaborations
get_files_id_comments	List file comments
get_files_id_tasks	List tasks on file
get_files_id_trash	Get trashed file
delete_files_id_trash	Permanently remove file
get_files_id_versions	List all file versions
get_files_id_versions_id	Get file version
delete_files_id_versions_id	Remove file version
put_files_id_versions_id	Restore file version
post_files_id_versions_current	Promote file version
get_files_id_metadata	List metadata instances on file
get_files_id_security_classification	Get classification on file
post_files_id_security_classification	Add classification to file
put_files_id_security_classification	Update classification on file
delete_files_id_security_classification	Remove classification from file
get_files_id_metadata_id_id	Get metadata instance on file
post_files_id_metadata_id_id	Create metadata instance on file
put_files_id_metadata_id_id	Update metadata instance on file
delete_files_id_metadata_id_id	Remove metadata instance from file
get_files_id_metadata_global_boxSkillsCards	List Box Skill cards on file
post_files_id_metadata_global_boxSkillsCards	Create Box Skill cards on file
put_files_id_metadata_global_boxSkillsCards	Update Box Skill cards on file
delete_files_id_metadata_global_boxSkillsCards	Remove Box Skill cards from file
get_files_id_watermark	Get watermark on file
put_files_id_watermark	Apply watermark to file
delete_files_id_watermark	Remove watermark from file
get_file_requests_id	Get file request
put_file_requests_id	Update file request
delete_file_requests_id	Delete file request
post_file_requests_id_copy	Copy file request
get_folders_id	Get folder information
post_folders_id	Restore folder
put_folders_id	Update folder
delete_folders_id	Delete folder
get_folders_id_app_item_associations	List folder app item associations
get_folders_id_items	List items in folder
post_folders	Create folder
post_folders_id_copy	Copy folder
get_folders_id_collaborations	List folder collaborations
get_folders_id_trash	Get trashed folder
delete_folders_id_trash	Permanently remove folder
get_folders_id_metadata	List metadata instances on folder
get_folders_id_security_classification	Get classification on folder
post_folders_id_security_classification	Add classification to folder
put_folders_id_security_classification	Update classification on folder
delete_folders_id_security_classification	Remove classification from folder
get_folders_id_metadata_id_id	Get metadata instance on folder
post_folders_id_metadata_id_id	Create metadata instance on folder
put_folders_id_metadata_id_id	Update metadata instance on folder
delete_folders_id_metadata_id_id	Remove metadata instance from folder
get_folders_trash_items	List trashed items
get_folders_id_watermark	Get watermark for folder
put_folders_id_watermark	Apply watermark to folder
delete_folders_id_watermark	Remove watermark from folder
get_folder_locks	List folder locks
post_folder_locks	Create folder lock
delete_folder_locks_id	Delete folder lock
get_metadata_templates	Find metadata template by instance ID
get_metadata_template_security_classification_schema	List all classifications
put_metadata_template_security_classification_schema_add	Add classification
put_metadata_template_security_classification_schema_update	Update classification
get_metadata_templates_id_id_schema	Get metadata template by name
put_metadata_templates_id_id_schema	Update metadata template
delete_metadata_templates_id_id_schema	Remove metadata template
get_metadata_templates_id	Get metadata template by ID
get_metadata_templates_global	List all global metadata templates
get_metadata_templates_enterprise	List all metadata templates for enterprise
post_metadata_templates_schema	Create metadata template
post_metadata_templates_schema_classifications	Add initial classifications
get_metadata_cascade_policies	List metadata cascade policies
post_metadata_cascade_policies	Create metadata cascade policy
get_metadata_cascade_policies_id	Get metadata cascade policy
delete_metadata_cascade_policies_id	Remove metadata cascade policy
post_metadata_cascade_policies_id_apply	Force-apply metadata cascade policy to folder
post_metadata_queries_execute_read	Query files/folders by metadata
get_comments_id	Get comment
put_comments_id	Update comment
delete_comments_id	Remove comment
post_comments	Create comment
get_collaborations_id	Get collaboration
put_collaborations_id	Update collaboration
delete_collaborations_id	Remove collaboration
get_collaborations	List pending collaborations
post_collaborations	Create collaboration
get_search	Search for content
post_tasks	Create task
get_tasks_id	Get task
put_tasks_id	Update task
delete_tasks_id	Remove task
get_tasks_id_assignments	List task assignments
post_task_assignments	Assign task
get_task_assignments_id	Get task assignment
put_task_assignments_id	Update task assignment
delete_task_assignments_id	Unassign task
get_shared_items	Find file for shared link
get_files_id_get_shared_link	Get shared link for file
put_files_id_add_shared_link	Add shared link to file
put_files_id_update_shared_link	Update shared link on file
put_files_id_remove_shared_link	Remove shared link from file
get_shared_items_folders	Find folder for shared link
get_folders_id_get_shared_link	Get shared link for folder
put_folders_id_add_shared_link	Add shared link to folder
put_folders_id_update_shared_link	Update shared link on folder
put_folders_id_remove_shared_link	Remove shared link from folder
post_web_links	Create web link
get_web_links_id	Get web link
post_web_links_id	Restore web link
put_web_links_id	Update web link
delete_web_links_id	Remove web link
get_web_links_id_trash	Get trashed web link
delete_web_links_id_trash	Permanently remove web link
get_shared_items_web_links	Find web link for shared link
get_web_links_id_get_shared_link	Get shared link for web link
put_web_links_id_add_shared_link	Add shared link to web link
put_web_links_id_update_shared_link	Update shared link on web link
put_web_links_id_remove_shared_link	Remove shared link from web link
get_shared_items_app_items	Find app item for shared link
get_users	List enterprise users
post_users	Create user
get_users_me	Get current user
post_users_terminate_sessions	Create jobs to terminate users session
get_users_id	Get user
put_users_id	Update user
delete_users_id	Delete user
get_users_id_avatar	Get user avatar
delete_users_id_avatar	Delete user avatar
put_users_id_folders_0	Transfer owned folders
get_users_id_email_aliases	List user's email aliases
post_users_id_email_aliases	Create email alias
delete_users_id_email_aliases_id	Remove email alias
get_users_id_memberships	List user's groups
post_invites	Create user invite
get_invites_id	Get user invite status
get_groups	List groups for enterprise
post_groups	Create group
post_groups_terminate_sessions	Create jobs to terminate user group session
get_groups_id	Get group
put_groups_id	Update group
delete_groups_id	Remove group
get_groups_id_memberships	List members of group
get_groups_id_collaborations	List group collaborations
post_group_memberships	Add user to group
get_group_memberships_id	Get group membership
put_group_memberships_id	Update group membership
delete_group_memberships_id	Remove user from group
get_webhooks	List all webhooks
post_webhooks	Create webhook
get_webhooks_id	Get webhook
put_webhooks_id	Update webhook
delete_webhooks_id	Remove webhook
put_skill_invocations_id	Update all Box Skill cards on file
options_events	Get events long poll endpoint
get_events	List user and enterprise events
get_collections	List all collections
get_collections_id_items	List collection items
get_collections_id	Get collection by ID
get_recent_items	List recently accessed items
get_retention_policies	List retention policies
post_retention_policies	Create retention policy
get_retention_policies_id	Get retention policy
put_retention_policies_id	Update retention policy
delete_retention_policies_id	Delete retention policy
get_retention_policies_id_assignments	List retention policy assignments
post_retention_policy_assignments	Assign retention policy
get_retention_policy_assignments_id	Get retention policy assignment
delete_retention_policy_assignments_id	Remove retention policy assignment
get_retention_policy_assignments_id_files_under_retention	Get files under retention
get_retention_policy_assignments_id_versions_under_retention	Get file versions under retention
get_legal_hold_policies	List all legal hold policies
post_legal_hold_policies	Create legal hold policy
get_legal_hold_policies_id	Get legal hold policy
put_legal_hold_policies_id	Update legal hold policy
delete_legal_hold_policies_id	Remove legal hold policy
get_legal_hold_policy_assignments	List legal hold policy assignments
post_legal_hold_policy_assignments	Assign legal hold policy
get_legal_hold_policy_assignments_id	Get legal hold policy assignment
delete_legal_hold_policy_assignments_id	Unassign legal hold policy
get_legal_hold_policy_assignments_id_files_on_hold	List files with current file versions for legal hold policy assignment
get_file_version_retentions	List file version retentions
get_legal_hold_policy_assignments_id_file_versions_on_hold	List previous file versions for legal hold policy assignment
get_file_version_retentions_id	Get retention on file
get_file_version_legal_holds_id	Get file version legal hold
get_file_version_legal_holds	List file version legal holds
get_shield_information_barriers_id	Get shield information barrier with specified ID
post_shield_information_barriers_change_status	Add changed status of shield information barrier with specified ID
get_shield_information_barriers	List shield information barriers
post_shield_information_barriers	Create shield information barrier
get_shield_information_barrier_reports	List shield information barrier reports
post_shield_information_barrier_reports	Create shield information barrier report
get_shield_information_barrier_reports_id	Get shield information barrier report by ID
get_shield_information_barrier_segments_id	Get shield information barrier segment with specified ID
delete_shield_information_barrier_segments_id	Delete shield information barrier segment
put_shield_information_barrier_segments_id	Update shield information barrier segment with specified ID
get_shield_information_barrier_segments	List shield information barrier segments
post_shield_information_barrier_segments	Create shield information barrier segment
get_shield_information_barrier_segment_members_id	Get shield information barrier segment member by ID
delete_shield_information_barrier_segment_members_id	Delete shield information barrier segment member by ID
get_shield_information_barrier_segment_members	List shield information barrier segment members
post_shield_information_barrier_segment_members	Create shield information barrier segment member
get_shield_information_barrier_segment_restrictions_id	Get shield information barrier segment restriction by ID
delete_shield_information_barrier_segment_restrictions_id	Delete shield information barrier segment restriction by ID
get_shield_information_barrier_segment_restrictions	List shield information barrier segment restrictions
post_shield_information_barrier_segment_restrictions	Create shield information barrier segment restriction
get_device_pinners_id	Get device pin
delete_device_pinners_id	Remove device pin
get_enterprises_id_device_pinners	List enterprise device pins
get_terms_of_services	List terms of services
post_terms_of_services	Create terms of service
get_terms_of_services_id	Get terms of service
put_terms_of_services_id	Update terms of service
get_terms_of_service_user_statuses	List terms of service user statuses
post_terms_of_service_user_statuses	Create terms of service status for new user
put_terms_of_service_user_statuses_id	Update terms of service status for existing user
get_collaboration_whitelist_entries	List allowed collaboration domains
post_collaboration_whitelist_entries	Add domain to list of allowed collaboration domains
get_collaboration_whitelist_entries_id	Get allowed collaboration domain
delete_collaboration_whitelist_entries_id	Remove domain from list of allowed collaboration domains
get_collaboration_whitelist_exempt_targets	List users exempt from collaboration domain restrictions
post_collaboration_whitelist_exempt_targets	Create user exemption from collaboration domain restrictions
get_collaboration_whitelist_exempt_targets_id	Get user exempt from collaboration domain restrictions
delete_collaboration_whitelist_exempt_targets_id	Remove user from list of users exempt from domain restrictions
get_storage_policies	List storage policies
get_storage_policies_id	Get storage policy
get_storage_policy_assignments	List storage policy assignments
post_storage_policy_assignments	Assign storage policy
get_storage_policy_assignments_id	Get storage policy assignment
put_storage_policy_assignments_id	Update storage policy assignment
delete_storage_policy_assignments_id	Unassign storage policy
post_zip_downloads	Create zip download
get_zip_downloads_id_content	Download zip archive
get_zip_downloads_id_status	Get zip download status
post_sign_requests_id_cancel	Cancel Box Sign request
post_sign_requests_id_resend	Resend Box Sign request
get_sign_requests_id	Get Box Sign request by ID
get_sign_requests	List Box Sign requests
post_sign_requests	Create Box Sign request
get_workflows	List workflows
post_workflows_id_start	Starts workflow based on request body
get_sign_templates	List Box Sign templates
get_sign_templates_id	Get Box Sign template by ID
get_integration_mappings_slack	List Slack integration mappings
post_integration_mappings_slack	Create Slack integration mapping
put_integration_mappings_slack_id	Update Slack integration mapping
delete_integration_mappings_slack_id	Delete Slack integration mapping
get_integration_mappings_teams	List Teams integration mappings
post_integration_mappings_teams	Create Teams integration mapping
put_integration_mappings_teams_id	Update Teams integration mapping
delete_integration_mappings_teams_id	Delete Teams integration mapping
post_ai_ask	Ask question
post_ai_text_gen	Generate text
get_ai_agent_default	Get AI agent default configuration
post_ai_extract	Extract metadata (freeform)
post_ai_extract_structured	Extract metadata (structured)
get_ai_agents	List AI agents
post_ai_agents	Create AI agent
put_ai_agents_id	Update AI agent
get_ai_agents_id	Get AI agent by agent ID
delete_ai_agents_id	Delete AI agent
post_metadata_taxonomies	Create metadata taxonomy
get_metadata_taxonomies_id	Get metadata taxonomies for namespace
get_metadata_taxonomies_id_id	Get metadata taxonomy by taxonomy key
patch_metadata_taxonomies_id_id	Update metadata taxonomy
delete_metadata_taxonomies_id_id	Remove metadata taxonomy
post_metadata_taxonomies_id_id_levels	Create metadata taxonomy levels
patch_metadata_taxonomies_id_id_levels_id	Update metadata taxonomy level
post_metadata_taxonomies_id_id_levels_append	Add metadata taxonomy level
post_metadata_taxonomies_id_id_levels_trim	Delete metadata taxonomy level
get_metadata_taxonomies_id_id_nodes	List metadata taxonomy nodes
post_metadata_taxonomies_id_id_nodes	Create metadata taxonomy node
get_metadata_taxonomies_id_id_nodes_id	Get metadata taxonomy node by ID
patch_metadata_taxonomies_id_id_nodes_id	Update metadata taxonomy node
delete_metadata_taxonomies_id_id_nodes_id	Remove metadata taxonomy node
get_metadata_templates_id_id_fields_id_options	List metadata template's options for taxonomy field