Integration · Documents

Connect Claude & ChatGPT to Box

Ask your AI to find the latest contract, what is in a folder, or who a file is shared with in Box. It searches files and folders, reads details, versions, comments and tasks, and shows collaborators. It can also create folders, move and rename files, share them with people or by link, and add comments and tasks.

Connect Box free

Free plan, no credit card. Takes about a minute.

Try asking

“Find the signed lease agreement from this year.”
The AI searches Box by name, description and file text, filtered by date, and lists the matches with folder and modified date.
“What is in the Projects/2026 folder?”
It lists the files, folders and web links in the folder.
“Who has access to the Board folder?”
It lists the folder's collaborators and their roles.

What your AI can do

Find files

Search files, folders and web links, list folder contents and recent items, and read file details and earlier versions.

Organize

Create folders, copy files, and rename, move or describe files and folders. Deleted files go to the trash.

Share and collaborate

Add collaborators, create shared links, and read or add comments and review tasks on files.

“Share the Q3 report with [email protected] as a viewer.”
It adds Anna as a collaborator with the viewer role. She gets an email invitation from Box.
“Ask Peter to review the new price list by Friday.”
It creates a review task on the file with a due date and assigns it to Peter, who is notified.
“Move all invoices from Downloads into Finance/Invoices.”
It finds the files and moves them by changing their parent folder.

283 tools for Box

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

add_classification_to_folderChanges dataCreate a new security classification 6 vm vochw u wo. API summary: Add classification to folder.
add_collaboratorChanges dataShare a file or folder with a person or group. Pass item (id, type), accessible_by (login email or id, type) and role (e.g. viewer, editor). The person gets an email invitation.
add_commentChanges dataComment on a file or reply to a comment. Pass item with id and type ('file' or 'comment') and message. Collaborators are notified.
assign_taskChanges dataAssign a file task to a user. Pass task (id) and assign_to (user id or login). The user is notified.
cancel_sign_requestDeletesCancel a sign request (sign request id). Destructive action; may require approval. API summary: Cancel Box Sign request.
copy_fileVisible to othersCopy a file into a folder. Pass file_id and parent with the destination folder id; optional new name.
create_ai_agentChanges dataCreate a new ai agent. Required: type, name or access state. API summary: Create AI agent.
create_askChanges dataCreate a new ask. Required: mode, prompt or items. API summary: Ask question.
create_box_skills_cardChanges dataCreate a new box skills card. Required: cards. API summary: Create Box Skill cards on file.
create_change_statusChanges dataCreate a new change status. Required: id or status. API summary: Add changed status of shield information barrier with specified ID.
create_collaboration_whitelist_exempt_targetChanges dataCreate a new collaboration whitelist exempt target. Required: user. API summary: Create user exemption from collaboration domain restrictions.
create_documentChanges dataCreate a new document for a document. Required: parts. API summary: Plan upload session.
create_document_post_files_id_versions_currentChanges dataCreate a new document. API summary: Promote file version.
create_document_post_files_upload_sessions_id_commitChanges dataCreate a new document for a document. Required: digest or parts. API summary: Commit upload session.
create_email_aliasVisible to othersEmail a user (user id). Has effects visible outside this system. API summary: Create email alias.
create_execute_readChanges dataCreate a new execute read. Required: from or ancestor folder id. API summary: Query files/folders by metadata.
create_extractChanges dataCreate a new extract. Required: prompt or items. API summary: Extract metadata (freeform).
create_extract_structuredChanges dataCreate a new extract structured. Required: items. API summary: Extract metadata (structured).
create_file_shared_linkVisible to othersCreate or update a shared link for a file. Pass document_id, fields='shared_link' and shared_link with access (open, company, collaborators). An open link lets anyone with the URL view the file.
create_file_taskChanges dataCreate a task on a file (review or complete). Pass item with the file id; optional message, action and due_at.
create_folderChanges dataCreate a folder. Pass name and parent with the parent folder id ('0' for the root).
create_folder_lockChanges dataCreate a new folder lock. Required: folder. API summary: Create folder lock.
create_folder_shared_linkVisible to othersCreate or update a shared link for a folder. Pass folder_id, fields='shared_link' and shared_link with access (open, company, collaborators). An open link lets anyone with the URL view the folder.
create_groupChanges dataCreate a new group. Required: name. Search groups first to avoid duplicates. API summary: Create group.
create_inviteChanges dataCreate a new invite. Required: enterprise or actionable by. API summary: Create user invite.
create_jobs_to_terminate_user_group_sessionChanges dataCreate a new terminate session. Required: group ids. API summary: Create jobs to terminate user group session.
create_legal_hold_policyChanges dataCreate a new legal hold policy. Required: policy name. API summary: Create legal hold policy.
create_legal_hold_policy_assignmentChanges dataCreate a new legal hold policy assignment. Required: policy id or assign to. API summary: Assign legal hold policy.
create_metadata_cascade_policyChanges dataCreate a new metadata cascade policy. Required: folder id, scope or template key. API summary: Create metadata cascade policy.
create_metadata_cascade_policy_applyChanges dataCreate a new apply for a metadata cascade policy. Required: conflict resolution. API summary: Force-apply metadata cascade policy to folder.
create_metadata_taxonomyChanges dataCreate a new metadata taxonomy. Required: display name or namespace. API summary: Create metadata taxonomy.
create_metadata_taxonomy_levelChanges dataCreate a new level for a metadata taxonomy. API summary: Create metadata taxonomy levels.
create_metadata_taxonomy_levels_appendChanges dataCreate a new levels append for a metadata taxonomy. Required: display name. API summary: Add metadata taxonomy level.
create_metadata_taxonomy_levels_trimChanges dataCreate a new levels trim for a metadata taxonomy. API summary: Delete metadata taxonomy level.
create_metadata_taxonomy_nodeChanges dataCreate a new node for a metadata taxonomy. Required: display name or level. Search nodes first to avoid duplicates. API summary: Create metadata taxonomy node.
create_pageChanges dataCreate a new page. Required: domain or direction. API summary: Add domain to list of allowed collaboration domains.
create_retention_policyChanges dataCreate a new retention policy. Required: policy name, policy type or disposition action. API summary: Create retention policy.
create_retention_policy_assignmentChanges dataCreate a new retention policy assignment. Required: policy id or assign to. API summary: Assign retention policy.
create_revokeChanges dataCreate a new revoke. API summary: Revoke access token.
create_schemaChanges dataCreate a new schema. Required: scope or display name. API summary: Create metadata template.
create_schema_classificationChanges dataCreate a new schema classification. Required: scope, template key, display name or fields. API summary: Add initial classifications.
create_security_classification_6_vm_vochw_u_woChanges dataCreate a new security classification 6 vm vochw u wo. API summary: Add classification to file.
create_shield_information_barrierChanges dataCreate a new shield information barrier. Required: enterprise. API summary: Create shield information barrier.
create_shield_information_barrier_reportChanges dataCreate a new shield information barrier report. API summary: Create shield information barrier report.
create_shield_information_barrier_segmentChanges dataCreate a new shield information barrier segment. Required: shield information barrier or name. API summary: Create shield information barrier segment.
create_shield_information_barrier_segment_memberChanges dataCreate a new user. Required: shield information barrier segment or user. Search users first to avoid duplicates. API summary: Create shield information barrier segment member.
create_shield_information_barrier_segment_restrictionChanges dataCreate a new shield information barrier segment restriction. Required: type, shield information barrier segment or restricted segment. API summary: Create shield information barrier segment restriction.
create_sign_requestChanges dataCreate a new sign request. Required: signers. API summary: Create Box Sign request.
create_slackChanges dataCreate a new slack. Required: partner item or box item. API summary: Create Slack integration mapping.
create_storage_policy_assignmentChanges dataCreate a new storage policy assignment. Required: storage policy or assigned to. API summary: Assign storage policy.
create_subscriptionChanges dataCreate a new subscription. Required: user or group. API summary: Add user to group.
create_teamChanges dataCreate a new team. Required: partner item or box item. API summary: Create Teams integration mapping.
create_terminate_sessionChanges dataCreate a new terminate session. Required: user ids or user logins. API summary: Create jobs to terminate users session.
create_terms_of_serviceChanges dataCreate a new terms of service. Required: status or text. API summary: Create terms of service.
create_terms_of_service_status_for_new_userChanges dataCreate a new user. Required: tos, user or is accepted. Search users first to avoid duplicates. API summary: Create terms of service status for new user.
create_text_genChanges dataCreate a new text gen. Required: prompt or items. API summary: Generate text.
create_token_refreshDeletesCreate a new token refresh. Required: grant type, client id, client secret or refresh token. Destructive action; may require approval. API summary: Refresh access token.
create_upload_session_for_existing_fileChanges dataUpload a document (file id). API summary: Create upload session for existing file.
create_userChanges dataCreate a new user. Required: name. Search users first to avoid duplicates. API summary: Create user.
create_web_linkChanges dataCreate a new web link. Required: url or parent. API summary: Create web link.
create_web_link_shared_linkVisible to othersCreate a new web link. Required: fields. Has effects visible outside this system. API summary: Add shared link to web link.
create_webhookDeletesCreate a new webhook. Required: target, address or triggers. Destructive action; may require approval. API summary: Create webhook.
create_workflow_startChanges dataCreate a new start for a workflow. Required: flow, files or folder. API summary: Starts workflow based on request body.
create_zip_downloadChanges dataCreate a new zip download. Required: items. API summary: Create zip download.
delete_ai_agentDeletesPermanently delete a ai agent by agent id. Destructive action; may require approval. API summary: Delete AI agent.
delete_box_skills_cardsMoves moneyPermanently delete a box skills card by file id. Financial or irreversible action; may require approval. API summary: Remove Box Skill cards from file.
delete_collaborationDeletesPermanently delete a collaboration by collaboration id. Destructive action; may require approval. API summary: Remove collaboration.
delete_collaboration_whitelist_exempt_targetDeletesPermanently delete a collaboration whitelist exempt target by collaboration whitelist exempt target id. Destructive action; may require approval. API summary: Remove user from list of users exempt from domain restrictions.
delete_device_pinnerDeletesPermanently delete a device pinner by device pinner id. Destructive action; may require approval. API summary: Remove device pin.
delete_document_metadataDeletesPermanently delete a metadata by template key. Destructive action; may require approval. API summary: Remove metadata instance from file.
delete_document_watermarksMoves moneyPermanently delete a watermark by file id. Financial or irreversible action; may require approval. API summary: Remove watermark from file.
delete_documentsMoves moneyPermanently delete a document by file id. Financial or irreversible action; may require approval. API summary: Permanently remove file.
delete_documents_shared_linkMoves moneyPermanently delete a document by document id. Financial or irreversible action; may require approval. API summary: Remove shared link from file.
delete_fileDeletesMove a file to the trash; it can be restored from the trash until it is purged. Pass document_id.
delete_file_requestDeletesPermanently delete a document by document id. Destructive action; may require approval. API summary: Delete file request.
delete_folderDeletesPermanently delete a folder by folder id. Destructive action; may require approval. API summary: Delete folder.
delete_folder_lockDeletesPermanently delete a folder lock by folder lock id. Destructive action; may require approval. API summary: Delete folder lock.
delete_folder_metadataDeletesPermanently delete a metadata by template key. Destructive action; may require approval. API summary: Remove metadata instance from folder.
delete_folder_trashesMoves moneyPermanently delete a trash by folder id. Financial or irreversible action; may require approval. API summary: Permanently remove folder.
delete_folder_watermarksMoves moneyPermanently delete a watermark by folder id. Financial or irreversible action; may require approval. API summary: Remove watermark from folder.
delete_folders_shared_linkMoves moneyPermanently delete a folder by folder id. Financial or irreversible action; may require approval. API summary: Remove shared link from folder.
delete_groupDeletesPermanently delete a group by group id. Destructive action; may require approval. API summary: Remove group.
delete_legal_hold_policyDeletesPermanently delete a legal hold policy by legal hold policy id. Destructive action; may require approval. API summary: Remove legal hold policy.
delete_legal_hold_policy_assignmentDeletesPermanently delete a legal hold policy assignment by legal hold policy assignment id. Destructive action; may require approval. API summary: Unassign legal hold policy.
delete_messageDeletesPermanently delete a message by message id. Destructive action; may require approval. API summary: Remove comment.
delete_metadata_cascade_policyDeletesPermanently delete a metadata cascade policy by metadata cascade policy id. Destructive action; may require approval. API summary: Remove metadata cascade policy.
delete_metadata_taxonomyDeletesPermanently delete a metadata taxonomy by taxonomy key. Destructive action; may require approval. API summary: Remove metadata taxonomy.
delete_metadata_template_schemasMoves moneyPermanently delete a schema by template key. Financial or irreversible action; may require approval. API summary: Remove metadata template.
delete_nodeDeletesPermanently delete a node by node id. Destructive action; may require approval. API summary: Remove metadata taxonomy node.
delete_pageDeletesPermanently delete a page by page id. Destructive action; may require approval. API summary: Remove domain from list of allowed collaboration domains.
delete_retention_policyDeletesPermanently delete a retention policy by retention policy id. Destructive action; may require approval. API summary: Delete retention policy.
delete_retention_policy_assignmentDeletesPermanently delete a retention policy assignment by retention policy assignment id. Destructive action; may require approval. API summary: Remove retention policy assignment.
delete_security_classification_6_vm_vochw_u_wosMoves moneyPermanently delete a security classification 6 vm vochw u wo by file id. Financial or irreversible action; may require approval. API summary: Remove classification from file.
delete_shield_information_barrier_segmentDeletesPermanently delete a shield information barrier segment by shield information barrier segment id. Destructive action; may require approval. API summary: Delete shield information barrier segment.
delete_shield_information_barrier_segment_member_by_idDeletesPermanently delete a user by user id. Destructive action; may require approval. API summary: Delete shield information barrier segment member by ID.
delete_shield_information_barrier_segment_restrictionDeletesPermanently delete a shield information barrier segment restriction by shield information barrier segment restriction id. Destructive action; may require approval. API summary: Delete shield information barrier segment restriction by ID.
delete_slackDeletesPermanently delete a slack by integration mapping id. Destructive action; may require approval. API summary: Delete Slack integration mapping.
delete_storage_policy_assignmentDeletesPermanently delete a storage policy assignment by storage policy assignment id. Destructive action; may require approval. API summary: Unassign storage policy.
delete_subscriptionDeletesPermanently delete a subscription by subscription id. Destructive action; may require approval. API summary: Remove user from group.
delete_taskDeletesPermanently delete a task by task id. Destructive action; may require approval. API summary: Remove task.
delete_task_delete_task_assignments_idDeletesPermanently delete a task by task id. Destructive action; may require approval. API summary: Unassign task.
delete_teamDeletesPermanently delete a team by integration mapping id. Destructive action; may require approval. API summary: Delete Teams integration mapping.
delete_userDeletesPermanently delete a user by user id. Destructive action; may require approval. API summary: Delete user.
delete_user_email_aliasDeletesPermanently delete a email alias by email alias id. Destructive action; may require approval. API summary: Remove email alias.
delete_usersMoves moneyPermanently delete a user by user id. Financial or irreversible action; may require approval. API summary: Delete user avatar.
delete_web_linkDeletesPermanently delete a web link by web link id. Destructive action; may require approval. API summary: Remove web link.
delete_web_link_trashesMoves moneyPermanently delete a trash by web link id. Financial or irreversible action; may require approval. API summary: Permanently remove web link.
delete_web_links_shared_linkMoves moneyPermanently delete a web link by web link id. Financial or irreversible action; may require approval. API summary: Remove shared link from web link.
delete_webhookDeletesPermanently delete a webhook by webhook id. Destructive action; may require approval. API summary: Remove webhook.
find_app_item_for_shared_linkList products. API summary: Find app item for shared link.
find_file_for_shared_linkList products. API summary: Find file for shared link.
get_ai_agentGet one ai agent by agent id. API summary: Get AI agent by agent ID.
get_categoryGet one category by category id. API summary: Get collection by ID.
get_classification_on_folderList security classification 6 vm vochw u wos. API summary: Get classification on folder.
get_collaborationGet one collaboration by collaboration id. API summary: Get collaboration.
get_collaboration_whitelist_exempt_targetGet one collaboration whitelist exempt target by collaboration whitelist exempt target id. API summary: Get user exempt from collaboration domain restrictions.
get_current_userGet the signed-in Box user (name, login, storage used).
get_device_pinnerGet one device pinner by device pinner id. API summary: Get device pin.
get_document_metadataGet one metadata for a document by template key. API summary: Get metadata instance on file.
get_fileGet a file's details: name, size, owner, parent folder, modified date and shared link. Pass document_id (the file ID).
get_file_requestGet one document by document id. API summary: Get file request.
get_file_shared_linkGet a file's shared link and its settings. Pass document_id and fields='shared_link'.
get_file_versionGet one document for a document by file version id. API summary: Get file version.
get_file_version_legal_holdGet one document by document id. API summary: Get file version legal hold.
get_folderGet a folder's details and first items. Pass folder_id ('0' is the root 'All Files' folder).
get_folder_metadataGet one metadata for a folder by template key. API summary: Get metadata instance on folder.
get_folder_shared_linkGet a folder's shared link and its settings. Pass folder_id and fields='shared_link'.
get_groupGet one group by group id. API summary: Get group.
get_inviteGet one invite by invite id. API summary: Get user invite status.
get_legal_hold_policyGet one legal hold policy by legal hold policy id. API summary: Get legal hold policy.
get_legal_hold_policy_assignmentGet one legal hold policy assignment by legal hold policy assignment id. API summary: Get legal hold policy assignment.
get_messageGet one message by message id. API summary: Get comment.
get_metadata_cascade_policyGet one metadata cascade policy by metadata cascade policy id. API summary: Get metadata cascade policy.
get_metadata_taxonomyGet one metadata taxonomy by namespace. Results are paginated. API summary: Get metadata taxonomies for namespace.
get_metadata_taxonomy_by_taxonomy_keyGet one metadata taxonomy by taxonomy key. API summary: Get metadata taxonomy by taxonomy key.
get_metadata_templateGet one metadata template by template id. API summary: Get metadata template by ID.
get_nodeGet one node by node id. API summary: Get metadata taxonomy node by ID.
get_pageGet one page by page id. API summary: Get allowed collaboration domain.
get_retention_on_fileGet one document by document id. API summary: Get retention on file.
get_retention_policyGet one retention policy by retention policy id. API summary: Get retention policy.
get_retention_policy_assignmentGet one retention policy assignment by retention policy assignment id. API summary: Get retention policy assignment.
get_shield_information_barrierGet one shield information barrier by shield information barrier id. API summary: Get shield information barrier with specified ID.
get_shield_information_barrier_reportGet one shield information barrier report by shield information barrier report id. API summary: Get shield information barrier report by ID.
get_shield_information_barrier_segmentGet one shield information barrier segment by shield information barrier segment id. API summary: Get shield information barrier segment with specified ID.
get_shield_information_barrier_segment_member_by_idGet one user by user id. API summary: Get shield information barrier segment member by ID.
get_shield_information_barrier_segment_restrictionGet one shield information barrier segment restriction by shield information barrier segment restriction id. API summary: Get shield information barrier segment restriction by ID.
get_sign_requestGet one sign request by sign request id. API summary: Get Box Sign request by ID.
get_sign_templateGet one sign template by template id. API summary: Get Box Sign template by ID.
get_storage_policyGet one storage policy by storage policy id. API summary: Get storage policy.
get_storage_policy_assignmentGet one storage policy assignment by storage policy assignment id. API summary: Get storage policy assignment.
get_subscriptionGet one subscription by subscription id. API summary: Get group membership.
get_taskGet one task by task id. API summary: Get task.
get_task_assignmentGet one task by task id. API summary: Get task assignment.
get_terms_of_serviceGet one terms of service by terms of service id. API summary: Get terms of service.
get_trashed_fileList documents for a document. API summary: Get trashed file.
get_upload_sessionGet one document by document id. API summary: Get upload session.
get_userGet one user by user id. API summary: Get user.
get_user_avatarList users for a user. API summary: Get user avatar.
get_web_linkGet one web link by web link id. API summary: Get web link.
get_web_link_shared_linkGet one web link by web link id. API summary: Get shared link for web link.
get_webhookGet one webhook by webhook id. API summary: Get webhook.
get_zip_download_statusGet the current status of a zip download by zip download id. API summary: Get zip download status.
list_ai_agent_defaultsList ai agent defaults. Optional filters: mode, language or model. API summary: Get AI agent default configuration.
list_ai_agentsList ai agents. Optional filters: mode, agent state, include box default or marker. Results are paginated.
list_box_skills_cardsList box skills cards. API summary: List Box Skill cards on file.
list_categoriesList categories. Results are paginated. API summary: List all collections.
list_category_productsList products for a category. Results are paginated. API summary: List collection items.
list_collaboration_whitelist_exempt_targetsList collaboration whitelist exempt targets. Optional filters: marker. Results are paginated. API summary: List users exempt from collaboration domain restrictions.
list_collaborationsList collaborations. Optional filters: status. Results are paginated. API summary: List pending collaborations.
list_document_metadataList metadata for a document. Optional filters: view. API summary: List metadata instances on file.
list_document_productsList products for a document. Optional filters: marker or application type. Results are paginated. API summary: List file app item associations.
list_document_thumbnailsList thumbnails for a document. Optional filters: min height, min width, max height or max width. API summary: Get file thumbnail.
list_document_watermarksList watermarks for a document. API summary: Get watermark on file.
list_documentsList documents for a document. Optional filters: version. API summary: Download file.
list_enterprise_device_pinnersList device pinners for a enterprise. Optional filters: marker or direction. Results are paginated. API summary: List enterprise device pins.
list_enterprisesList enterprises. Optional filters: marker. Results are paginated. API summary: List all metadata templates for enterprise.
list_eventsList events. Optional filters: stream type, stream position, event type, created after or created before. Results are paginated. API summary: List user and enterprise events.
list_file_collaboratorsList who a file is shared with and their roles. Pass file_id.
list_file_commentsList the comments on a file. Pass file_id.
list_file_tasksList the review and to-do tasks on a file. Pass file_id.
list_file_version_legal_holdsList documents. Optional filters: policy id or marker. Results are paginated. API summary: List file version legal holds.
list_file_version_retentionsList documents. Optional filters: file id, file version id, policy id, disposition action, disposition before or disposition after. Results are paginated. API summary: List file version retentions.
list_file_versionsList earlier versions of a file. Pass file_id.
list_folder_collaboratorsList who a folder is shared with and their roles. Pass folder_id.
list_folder_itemsList the files, folders and web links in a folder. Pass folder_id ('0' for the root); use offset/limit to page.
list_folder_locksList folder locks. Optional filters: folder id.
list_folder_metadataList metadata for a folder. Optional filters: view. API summary: List metadata instances on folder.
list_folder_productsList products for a folder. Optional filters: marker or application type. Results are paginated. API summary: List folder app item associations.
list_folder_trashesList trashes for a folder. API summary: Get trashed folder.
list_folder_watermarksList watermarks for a folder. API summary: Get watermark for folder.
list_globalsList globals. Optional filters: marker. Results are paginated. API summary: List all global metadata templates.
list_group_collaborationsList collaborations for a group. Results are paginated. API summary: List group collaborations.
list_group_subscriptionsList subscriptions for a group. Results are paginated. API summary: List members of group.
list_legal_hold_policiesList legal hold policies. Optional filters: policy name or marker. Results are paginated. API summary: List all legal hold policies.
list_legal_hold_policy_assignment_file_versions_on_holdsList file versions on holds for a legal hold policy assignment. Optional filters: marker. Results are paginated. API summary: List previous file versions for legal hold policy assignment.
list_legal_hold_policy_assignment_files_on_holdsList files on holds for a legal hold policy assignment. Optional filters: marker. Results are paginated. API summary: List files with current file versions for legal hold policy assignment.
list_legal_hold_policy_assignmentsList legal hold policy assignments. Optional filters: policy id, assign to type, assign to id or marker. Results are paginated.
list_metadata_cascade_policiesList metadata cascade policies. Optional filters: folder id, owner enterprise id or marker. Results are paginated.
list_metadata_template_schemasList schemas for a metadata template. API summary: Get metadata template by name.
list_metadata_templatesList metadata templates. Optional filters: metadata instance id or marker. Results are paginated. API summary: Find metadata template by instance ID.
list_pagesList pages. Optional filters: marker. Results are paginated. API summary: List allowed collaboration domains.
list_partsList documents for a document. Results are paginated. API summary: List parts.
list_productsList products. Optional filters: usemarker, marker, direction or sort. Results are paginated. API summary: List trashed items.
list_recent_itemsList the files and folders you recently opened or edited.
list_retention_policiesList retention policies. Optional filters: policy name, policy type, created by user id or marker. Results are paginated.
list_retention_policy_assignment_file_versions_under_retentionsList file versions under retentions for a retention policy assignment. Optional filters: marker. Results are paginated. API summary: Get file versions under retention.
list_retention_policy_assignment_files_under_retentionsList files under retentions for a retention policy assignment. Optional filters: marker. Results are paginated. API summary: Get files under retention.
list_retention_policy_assignmentsList assignments for a retention policy. Optional filters: type or marker. Results are paginated. API summary: List retention policy assignments.
list_schemasList schemas. API summary: List all classifications.
list_security_classification_6_vm_vochw_u_wosList security classification 6 vm vochw u wos. API summary: Get classification on file.
list_shared_items_foldersList shared items folders. API summary: Find folder for shared link.
list_shared_items_web_linksList shared items web links. API summary: Find web link for shared link.
list_shield_information_barrier_reportsList shield information barrier reports. Optional filters: shield information barrier id or marker. Results are paginated.
list_shield_information_barrier_segment_membersList users. Optional filters: shield information barrier segment id or marker. Results are paginated. API summary: List shield information barrier segment members.
list_shield_information_barrier_segment_restrictionsList shield information barrier segment restrictions. Optional filters: shield information barrier segment id or marker. Results are paginated.
list_shield_information_barrier_segmentsList shield information barrier segments. Optional filters: shield information barrier id or marker. Results are paginated.
list_shield_information_barriersList shield information barriers. Optional filters: marker. Results are paginated.
list_sign_requestsList sign requests. Optional filters: marker, senders or shared requests. Results are paginated. API summary: List Box Sign requests.
list_sign_templatesList sign templates. Optional filters: marker. Results are paginated. API summary: List Box Sign templates.
list_slacksList slacks. Optional filters: marker, partner item type, partner item id, box item id, box item type or is manually created. Results are paginated. API summary: List Slack integration mappings.
list_storage_policiesList storage policies. Optional filters: marker. Results are paginated.
list_storage_policy_assignmentsList storage policy assignments. Optional filters: marker, resolved for type or resolved for id.
list_tasksList tasks for a task. API summary: List task assignments.
list_teamsList teams. Optional filters: partner item type, partner item id, box item id or box item type. API summary: List Teams integration mappings.
list_terms_of_service_user_statusesList users. Optional filters: tos id or user id. API summary: List terms of service user statuses.
list_terms_of_servicesList terms of services. Optional filters: tos type.
list_user_subscriptionsList subscriptions for a user. Results are paginated. API summary: List user's groups.
list_web_link_trashesList trashes for a web link. API summary: Get trashed web link.
list_webhooksList webhooks. Optional filters: marker. Results are paginated. API summary: List all webhooks.
list_workflowsList workflows. Optional filters: folder id, trigger type or marker. Results are paginated.
list_zip_download_contentsList contents for a zip download. API summary: Download zip archive.
remove_classification_from_folderMoves moneyPermanently delete a security classification 6 vm vochw u wo by folder id. Financial or irreversible action; may require approval. API summary: Remove classification from folder.
remove_file_versionDeletesPermanently delete a document by file version id. Destructive action; may require approval. API summary: Remove file version.
remove_upload_sessionDeletesPermanently delete a document by document id. Destructive action; may require approval. API summary: Remove upload session.
restore_file_versionChanges dataUpdate an existing document identified by file version id. API summary: Restore file version.
search_contentSearch files, folders and web links by name, description or file text. Pass query; filter by type, file_extensions, ancestor_folder_ids or date ranges.
search_field_optionsSearch options for a field by level, parent, ancestor, query, include total result count or only selectable options. Use this to find existing options before creating a new option. Results are paginated. API summary: List metadata template's options for taxonomy field.
search_groupsSearch groups by filter term. Use this to find existing groups before creating a new group. Results are paginated. API summary: List groups for enterprise.
search_metadata_taxonomy_nodesSearch nodes for a metadata taxonomy by level, parent, ancestor, query, include total result count or marker. Use this to find existing nodes before creating a new node. Results are paginated. API summary: List metadata taxonomy nodes.
search_usersSearch users by filter term, user type, external app user id, usemarker or marker. Use this to find existing users before creating a new user. Results are paginated. API summary: List enterprise users.
send_user_aliasesVisible to othersEmail a user (user id). Has effects visible outside this system. API summary: List user's email aliases.
submit_document_copyVisible to othersCopy a document (file request id). Has effects visible outside this system. API summary: Copy file request.
submit_folderVisible to othersCopy a folder (folder id). Has effects visible outside this system. API summary: Copy folder.
submit_sign_requestVisible to othersResend a sign request (sign request id). Has effects visible outside this system. API summary: Resend Box Sign request.
update_ai_agentChanges dataUpdate an existing ai agent identified by agent id. API summary: Update AI agent.
update_box_skills_cardsVisible to othersUpdate an existing box skills card identified by file id. Has effects visible outside this system. API summary: Update Box Skill cards on file.
update_collaborationChanges dataUpdate an existing collaboration identified by collaboration id. API summary: Update collaboration.
update_document_metadataChanges dataUpdate an existing metadata identified by template key. API summary: Update metadata instance on file.
update_document_watermarksVisible to othersUpdate an existing watermark identified by file id. Has effects visible outside this system. API summary: Apply watermark to file.
update_documents_shared_linkVisible to othersUpdate an existing document identified by document id. Has effects visible outside this system. API summary: Update shared link on file.
update_fileChanges dataRename, move or describe a file, or change its tags. Pass document_id and name, description, tags or parent (to move).
update_file_requestChanges dataUpdate an existing document identified by document id. API summary: Update file request.
update_folderChanges dataRename, move or describe a folder. Pass folder_id and name, description or parent (to move).
update_folder_metadataChanges dataUpdate an existing metadata identified by template key. API summary: Update metadata instance on folder.
update_folder_watermarksVisible to othersUpdate an existing watermark identified by folder id. Has effects visible outside this system. API summary: Apply watermark to folder.
update_folders_shared_linkVisible to othersUpdate an existing folder identified by folder id. Has effects visible outside this system. API summary: Update shared link on folder.
update_groupChanges dataUpdate an existing group identified by group id. API summary: Update group.
update_legal_hold_policyChanges dataUpdate an existing legal hold policy identified by legal hold policy id. API summary: Update legal hold policy.
update_levelChanges dataUpdate an existing level identified by level index. Only the fields you pass are changed. API summary: Update metadata taxonomy level.
update_messageChanges dataUpdate an existing message identified by message id. API summary: Update comment.
update_metadata_taxonomyChanges dataUpdate an existing metadata taxonomy identified by taxonomy key. Only the fields you pass are changed. API summary: Update metadata taxonomy.
update_metadata_template_schemasVisible to othersUpdate an existing schema identified by template key. Has effects visible outside this system. API summary: Update metadata template.
update_nodeChanges dataUpdate an existing node identified by node id. Only the fields you pass are changed. API summary: Update metadata taxonomy node.
update_retention_policyChanges dataUpdate an existing retention policy identified by retention policy id. API summary: Update retention policy.
update_rootsVisible to othersUpdate an existing root identified by user id. Has effects visible outside this system. API summary: Transfer owned folders.
update_schema_addsVisible to othersUpdate an existing schema add. Has effects visible outside this system. API summary: Add classification.
update_schema_updatesVisible to othersUpdate an existing schema update. Has effects visible outside this system. API summary: Update classification.
update_security_classification_6_vm_vochw_u_wosVisible to othersUpdate an existing security classification 6 vm vochw u wo identified by file id. Has effects visible outside this system. API summary: Update classification on file.
update_shield_information_barrier_segmentChanges dataUpdate an existing shield information barrier segment identified by shield information barrier segment id. API summary: Update shield information barrier segment with specified ID.
update_skill_invocationChanges dataUpdate an existing skill invocation identified by skill id. API summary: Update all Box Skill cards on file.
update_slackChanges dataUpdate an existing slack identified by integration mapping id. API summary: Update Slack integration mapping.
update_storage_policy_assignmentChanges dataUpdate an existing storage policy assignment identified by storage policy assignment id. API summary: Update storage policy assignment.
update_subscriptionChanges dataUpdate an existing subscription identified by subscription id. API summary: Update group membership.
update_taskChanges dataUpdate an existing task identified by task id. API summary: Update task.
update_task_assignmentChanges dataUpdate an existing task identified by task id. API summary: Update task assignment.
update_teamChanges dataUpdate an existing team identified by integration mapping id. API summary: Update Teams integration mapping.
update_terms_of_serviceChanges dataUpdate an existing terms of service identified by terms of service id. API summary: Update terms of service.
update_terms_of_service_status_for_existing_userChanges dataUpdate an existing user identified by user id. API summary: Update terms of service status for existing user.
update_userChanges dataUpdate an existing user identified by user id. API summary: Update user.
update_web_linkChanges dataUpdate an existing web link identified by web link id. API summary: Update web link.
update_web_links_shared_linkVisible to othersUpdate an existing web link identified by web link id. Has effects visible outside this system. API summary: Update shared link on web link.
update_webhookDeletesUpdate an existing webhook identified by webhook id. Destructive action; may require approval. API summary: Update webhook.
upload_document_sessionsChanges dataUpload a document. API summary: Create upload session.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Box from the app list.
2
Paste your key
Paste the Client ID and Client secret from your own Box app, then sign in to Box once. In the Box Developer Console click Create New App > Custom App > User Authentication (OAuth 2.0). On the Configuration tab add the redirect URI https://heymyapps.com/oauth/callback, tick the scopes you need (for example Read and write all files and folders) and copy the Client ID and Client secret. HeyMyApps renews access automatically after that.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Box?

The AI can search content and read files, folders, recent items, versions, comments, tasks, collaborators and shared links. It can create folders, copy, rename, move and describe files and folders, move files to the trash, share items with people or by link, and add comments and tasks.

Does the AI see my Box credentials?

No. Your Box credentials are encrypted at rest and never shown to the AI. After you save them, they are not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start read-only. Shared links, invitations and moving files to the trash can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

Box connects with OAuth, and OAuth connections need the HeyMyApps Pro plan or above. HeyMyApps also has a free plan with no credit card, but it does not include this connection. Paid plans bill per completed task. You also need your own Box account.

Why do I create my own Box app?

Box connects through an app you own in the Box Developer Console, so you decide its scopes and can revoke it at any time. You paste its Client ID and Client secret into HeyMyApps and sign in to Box once. HeyMyApps then renews access automatically, and the AI can only reach what your Box user can reach.