# Box connector

[Product](https://paperclip.ing/product/) / [Connectors](https://paperclip.ing/product/connectors/) / Box

Search files, read their content and add comments.

Category: [Content](/product/connectors/?category=content)
Tools from: [Box](https://developer.box.com/guides/box-mcp/tools/)
Sign-in: Your own OAuth app
Works as: Agent tool

Source recorded: Sep 30, 2026

## Overview

Paperclip’s Box connector gives your AI agents tools to search files, read file contents and details and comment on files through its MCP server. Each tool can be Allowed, Ask first or Off.

File and folder reach comes from the Box account you authorize. Enterprise content and app policies can further restrict access.

## What agents can do with Box

- Find files and inspect their details (`search_files_keyword`, `get_file_details`)
- Read a file with its metadata (`get_file_details`, `get_file_content`)
- Comment on a file after checking its details (`get_file_details`, `create_file_comment`)

## How to connect Box

1. In Paperclip, open Connectors and select Box.
2. On the Access step, choose the identity and which agents may use the connection.
3. Select Use your own OAuth app and copy Paperclip’s callback URI. Have a Box administrator enable AI access and create integration credentials with that URI, then enter the client ID and secret and authorize the account.

[Setup guide](https://docs.paperclip.ing/connectors/box/)

## Box tools for agents (54)



### Write (54)

<div data-tool-name="add_file_shared_link" data-tool-class="write">
<code>add_file_shared_link</code>
<p class="c4-description-summary">Creates or updates a shared link for a Box file.</p>
<details class="faq-item c4-tool-description">
<summary class="faq-header" aria-label="Full description for add_file_shared_link">Full description</summary>

<pre class="faq-answer c4-description-text">Creates or updates a shared link for a Box file. Can create open shared links or add collaborators from outside your organization.</pre>
</details>
</div>

<div data-tool-name="add_folder_shared_link" data-tool-class="write">
<code>add_folder_shared_link</code>
<p class="c4-description-summary">Creates or updates a shared link for a Box folder.</p>
<details class="faq-item c4-tool-description">
<summary class="faq-header" aria-label="Full description for add_folder_shared_link">Full description</summary>

<pre class="faq-answer c4-description-text">Creates or updates a shared link for a Box folder. Can create open shared links or add collaborators from outside your organization.</pre>
</details>
</div>

<div data-tool-name="add_items_to_hub" data-tool-class="write">
<code>add_items_to_hub</code>
<p class="c4-description-summary">Adds files, folders, or web links to a hub.</p>
</div>

<div data-tool-name="ai_extract_freeform" data-tool-class="write">
<code>ai_extract_freeform</code>
<p class="c4-description-summary">Extracts metadata from files using Box AI with natural-language prompts (no fixed template).</p>
<details class="faq-item c4-tool-description">
<summary class="faq-header" aria-label="Full description for ai_extract_freeform">Full description</summary>

<pre class="faq-answer c4-description-text">Extracts metadata from files using Box AI with natural-language prompts (no fixed template). Text representation up to 1 MB. Supports documents, PDFs, presentations, and text. Works with one or more file_ids.</pre>
</details>
</div>

<div data-tool-name="ai_extract_structured" data-tool-class="write">
<code>ai_extract_structured</code>
<p class="c4-description-summary">Extracts structured key-value metadata from files using the Box AI Enhanced Extract Agent and custom field definitions.</p>
</div>

<div data-tool-name="ai_extract_structured_from_fields" data-tool-class="write">
<code>ai_extract_structured_from_fields</code>
<p class="c4-description-summary">Extracts structured metadata from files using Box AI and custom field definitions.</p>
<details class="faq-item c4-tool-description">
<summary class="faq-header" aria-label="Full description for ai_extract_structured_from_fields">Full description</summary>

<pre class="faq-answer c4-description-text">Extracts structured metadata from files using Box AI and custom field definitions. Works with one or more files. Field types include string, date, float, enum, and multiSelect.</pre>
</details>
</div>

<div data-tool-name="ai_extract_structured_from_fields_enhanced" data-tool-class="write">
<code>ai_extract_structured_from_fields_enhanced</code>
<p class="c4-description-summary">Extracts structured metadata from files using the Box AI Enhanced Extract Agent and custom field definitions.</p>
<details class="faq-item c4-tool-description">
<summary class="faq-header" aria-label="Full description for ai_extract_structured_from_fields_enhanced">Full description</summary>

<pre class="faq-answer c4-description-text">Extracts structured metadata from files using the Box AI Enhanced Extract Agent and custom field definitions. Use only when the user asks for the Enhanced Extract Agent. This tool costs more than the standard Box AI Extract tools. Field types include string, date, float, enum, and multiSelect.</pre>
</details>
</div>

<div data-tool-name="ai_extract_structured_from_metadata_template" data-tool-class="write">
<code>ai_extract_structured_from_metadata_template</code>
<p class="c4-description-summary">Extracts structured metadata from files using an existing Box metadata template.</p>
<details class="faq-item c4-tool-description">
<summary class="faq-header" aria-label="Full description for ai_extract_structured_from_metadata_template">Full description</summary>

<pre class="faq-answer c4-description-text">Extracts structured metadata from files using an existing Box metadata template. Requires template_key and scope (for example, enterprise or global). Processes the text representation of file content.</pre>
</details>
</div>

<div data-tool-name="ai_extract_structured_from_metadata_template_enhanced" data-tool-class="write">
<code>ai_extract_structured_from_metadata_template_enhanced</code>
<p class="c4-description-summary">Extracts structured metadata from files using an existing Box metadata template and the Enhanced Extract Agent.</p>
<details class="faq-item c4-tool-description">
<summary class="faq-header" aria-label="Full description for ai_extract_structured_from_metadata_template_enhanced">Full description</summary>

<pre class="faq-answer c4-description-text">Extracts structured metadata from files using an existing Box metadata template and the Enhanced Extract Agent. Use only when the user asks for the Enhanced Extract Agent. This tool costs more than the standard Box AI Extract tools.</pre>
</details>
</div>

<div data-tool-name="ai_qa_hub" data-tool-class="write">
<code>ai_qa_hub</code>
<p class="c4-description-summary">Asks a question about a Box hub and returns an answer based on the hub’s content, with citations when available.</p>
</div>

<div data-tool-name="ai_qa_multi_file" data-tool-class="write">
<code>ai_qa_multi_file</code>
<p class="c4-description-summary">Asks a question about multiple files using Box AI, with citations when available.</p>
</div>

<div data-tool-name="ai_qa_single_file" data-tool-class="write">
<code>ai_qa_single_file</code>
<p class="c4-description-summary">Asks a question about a single file using Box AI, with citations when available.</p>
<details class="faq-item c4-tool-description">
<summary class="faq-header" aria-label="Full description for ai_qa_single_file">Full description</summary>

<pre class="faq-answer c4-description-text">Asks a question about a single file using Box AI, with citations when available. Text representation up to 1 MB. If the file is larger, only the first 1 MB is processed.</pre>
</details>
</div>

<div data-tool-name="copy_file" data-tool-class="write">
<code>copy_file</code>
<p class="c4-description-summary">Copies an existing file to a destination folder in Box.</p>
</div>

<div data-tool-name="copy_folder" data-tool-class="write">
<code>copy_folder</code>
<p class="c4-description-summary">Copies an existing folder to a destination parent folder in Box.</p>
</div>

<div data-tool-name="copy_hub" data-tool-class="write">
<code>copy_hub</code>
<p class="c4-description-summary">Creates a copy of an existing hub, including its structure and settings.</p>
<details class="faq-item c4-tool-description">
<summary class="faq-header" aria-label="Full description for copy_hub">Full description</summary>

<pre class="faq-answer c4-description-text">Creates a copy of an existing hub, including its structure and settings. The original hub is not modified. The new title can have up to 50 characters; if you do not provide one, a default title is used.</pre>
</details>
</div>

<div data-tool-name="create_collaboration" data-tool-class="write">
<code>create_collaboration</code>
<p class="c4-description-summary">Invites a user or group to a file, folder, or hub.</p>
<details class="faq-item c4-tool-description">
<summary class="faq-header" aria-label="Full description for create_collaboration">Full description</summary>

<pre class="faq-answer c4-description-text">Invites a user or group to a file, folder, or hub. Can create open shared links or add collaborators from outside your organization.</pre>
</details>
</div>

<div data-tool-name="create_docgen_batch" data-tool-class="write">
<code>create_docgen_batch</code>
<p class="c4-description-summary">Generates documents from a Doc Gen template by filling placeholder tags with provided data.</p>
</div>

<div data-tool-name="create_docgen_template" data-tool-class="write">
<code>create_docgen_template</code>
<p class="c4-description-summary">Marks a Box file (.docx or .pptx) as a Doc Gen template for automated document generation.</p>
</div>

<div data-tool-name="create_file_comment" data-tool-class="write">
<code>create_file_comment</code>
<p class="c4-description-summary">Creates a comment on a file.</p>
</div>

<div data-tool-name="create_folder" data-tool-class="write">
<code>create_folder</code>
<p class="c4-description-summary">Creates a folder in Box.</p>
</div>

<div data-tool-name="create_hub" data-tool-class="write">
<code>create_hub</code>
<p class="c4-description-summary">Creates a hub.</p>
</div>

<div data-tool-name="create_metadata_template" data-tool-class="write">
<code>create_metadata_template</code>
<p class="c4-description-summary">Creates an enterprise metadata template.</p>
<details class="faq-item c4-tool-description">
<summary class="faq-header" aria-label="Full description for create_metadata_template">Full description</summary>

<pre class="faq-answer c4-description-text">Creates an enterprise metadata template. Requires the enterprise scope, display_name, and an optional fields array.</pre>
</details>
</div>

<div data-tool-name="get_docgen_template_by_id" data-tool-class="write">
<code>get_docgen_template_by_id</code>
<p class="c4-description-summary">Retrieves details about a Doc Gen template.</p>
</div>

<div data-tool-name="get_download_url" data-tool-class="write">
<code>get_download_url</code>
<p class="c4-description-summary">Issues a temporary, single-use URL for downloading binary files from Box.</p>
<details class="faq-item c4-tool-description">
<summary class="faq-header" aria-label="Full description for get_download_url">Full description</summary>

<pre class="faq-answer c4-description-text">Issues a temporary, single-use URL for downloading binary files from Box. See Upload and download URL tools for additional configuration details.</pre>
</details>
</div>

<div data-tool-name="get_file_content" data-tool-class="write">
<code>get_file_content</code>
<p class="c4-description-summary">Returns the content of a file stored in Box.</p>
</div>

<div data-tool-name="get_file_details" data-tool-class="write">
<code>get_file_details</code>
<p class="c4-description-summary">Returns detailed file information from Box, including metadata, permissions, and version details.</p>
</div>

<div data-tool-name="get_file_preview" data-tool-class="write">
<code>get_file_preview</code>
<p class="c4-description-summary">Returns the preview widget for a file stored in Box.</p>
</div>

<div data-tool-name="get_folder_details" data-tool-class="write">
<code>get_folder_details</code>
<p class="c4-description-summary">Retrieves detailed folder information, including metadata, permissions, and collaboration settings.</p>
</div>

<div data-tool-name="get_hub_details" data-tool-class="write">
<code>get_hub_details</code>
<p class="c4-description-summary">Retrieves detailed information about a specific hub.</p>
</div>

<div data-tool-name="get_hub_items" data-tool-class="write">
<code>get_hub_items</code>
<p class="c4-description-summary">Gets items (files and folders) associated with a specific hub.</p>
</div>

<div data-tool-name="get_metadata_template_schema" data-tool-class="write">
<code>get_metadata_template_schema</code>
<p class="c4-description-summary">Returns the schema and field keys for a metadata template.</p>
</div>

<div data-tool-name="get_upload_url" data-tool-class="write">
<code>get_upload_url</code>
<p class="c4-description-summary">Issues a temporary, single-use URL for uploading binary files to Box.</p>
<details class="faq-item c4-tool-description">
<summary class="faq-header" aria-label="Full description for get_upload_url">Full description</summary>

<pre class="faq-answer c4-description-text">Issues a temporary, single-use URL for uploading binary files to Box. See Upload and download URL tools for additional configuration details.</pre>
</details>
</div>

<div data-tool-name="list_docgen_templates" data-tool-class="write">
<code>list_docgen_templates</code>
<p class="c4-description-summary">Lists all Box Doc Gen templates that the authenticated user can access.</p>
</div>

<div data-tool-name="list_file_comments" data-tool-class="write">
<code>list_file_comments</code>
<p class="c4-description-summary">Lists all comments on a file.</p>
</div>

<div data-tool-name="list_folder_content_by_folder_id" data-tool-class="write">
<code>list_folder_content_by_folder_id</code>
<p class="c4-description-summary">Lists files, folders, and web links in a folder (paginated).</p>
<details class="faq-item c4-tool-description">
<summary class="faq-header" aria-label="Full description for list_folder_content_by_folder_id">Full description</summary>

<pre class="faq-answer c4-description-text">Lists files, folders, and web links in a folder (paginated). Use folder_id “0” for the root folder. id, type, name, and etag are always returned. Optional field: limit.</pre>
</details>
</div>

<div data-tool-name="list_hubs" data-tool-class="write">
<code>list_hubs</code>
<p class="c4-description-summary">Lists all hubs that the authenticated user can access.</p>
</div>

<div data-tool-name="list_item_collaborations" data-tool-class="write">
<code>list_item_collaborations</code>
<p class="c4-description-summary">Lists all existing collaborations on an item.</p>
</div>

<div data-tool-name="list_metadata_templates" data-tool-class="write">
<code>list_metadata_templates</code>
<p class="c4-description-summary">Lists available Box metadata templates (enterprise or global).</p>
</div>

<div data-tool-name="list_tasks" data-tool-class="write">
<code>list_tasks</code>
<p class="c4-description-summary">Lists all tasks for a file, including status, message, and due dates.</p>
</div>

<div data-tool-name="move_file" data-tool-class="write">
<code>move_file</code>
<p class="c4-description-summary">Moves an existing file to a destination folder in Box.</p>
<details class="faq-item c4-tool-description">
<summary class="faq-header" aria-label="Full description for move_file">Full description</summary>

<pre class="faq-answer c4-description-text">Moves an existing file to a destination folder in Box. The file ID stays the same and parent_folder_id is required.</pre>
</details>
</div>

<div data-tool-name="move_folder" data-tool-class="write">
<code>move_folder</code>
<p class="c4-description-summary">Moves a folder to a new parent in Box.</p>
<details class="faq-item c4-tool-description">
<summary class="faq-header" aria-label="Full description for move_folder">Full description</summary>

<pre class="faq-answer c4-description-text">Moves a folder to a new parent in Box. The folder ID stays the same and parent_folder_id is required.</pre>
</details>
</div>

<div data-tool-name="search_files_keyword" data-tool-class="write">
<code>search_files_keyword</code>
<p class="c4-description-summary">Searches for files using keywords.</p>
<details class="faq-item c4-tool-description">
<summary class="faq-header" aria-label="Full description for search_files_keyword">Full description</summary>

<pre class="faq-answer c4-description-text">Searches for files using keywords. Supports metadata filters, file-extension filtering, and field selection.</pre>
</details>
</div>

<div data-tool-name="search_files_metadata" data-tool-class="write">
<code>search_files_metadata</code>
<p class="c4-description-summary">Searches for files using SQL-like metadata queries.</p>
<details class="faq-item c4-tool-description">
<summary class="faq-header" aria-label="Full description for search_files_metadata">Full description</summary>

<pre class="faq-answer c4-description-text">Searches for files using SQL-like metadata queries. Supports complex filtering with parameters, field selection, and folder scoping.</pre>
</details>
</div>

<div data-tool-name="search_folders_by_name" data-tool-class="write">
<code>search_folders_by_name</code>
<p class="c4-description-summary">Searches for folders in Box by name using keyword matching.</p>
</div>

<div data-tool-name="set_file_metadata" data-tool-class="write">
<code>set_file_metadata</code>
<p class="c4-description-summary">Creates or updates (upserts) custom metadata on a file for a template.</p>
<details class="faq-item c4-tool-description">
<summary class="faq-header" aria-label="Full description for set_file_metadata">Full description</summary>

<pre class="faq-answer c4-description-text">Creates or updates (upserts) custom metadata on a file for a template. Use list_metadata_templates and get_metadata_template_schema to find the scope, template_key, and fields.</pre>
</details>
</div>

<div data-tool-name="set_folder_metadata" data-tool-class="write">
<code>set_folder_metadata</code>
<p class="c4-description-summary">Creates or updates (upserts) custom metadata on a folder for a template.</p>
<details class="faq-item c4-tool-description">
<summary class="faq-header" aria-label="Full description for set_folder_metadata">Full description</summary>

<pre class="faq-answer c4-description-text">Creates or updates (upserts) custom metadata on a folder for a template. Use list_metadata_templates and get_metadata_template_schema to find the scope, template_key, and fields.</pre>
</details>
</div>

<div data-tool-name="update_collaboration" data-tool-class="write">
<code>update_collaboration</code>
<p class="c4-description-summary">Updates a file, folder, or hub collaboration.</p>
<details class="faq-item c4-tool-description">
<summary class="faq-header" aria-label="Full description for update_collaboration">Full description</summary>

<pre class="faq-answer c4-description-text">Updates a file, folder, or hub collaboration. Can create open shared links or add collaborators from outside your organization.</pre>
</details>
</div>

<div data-tool-name="update_file_properties" data-tool-class="write">
<code>update_file_properties</code>
<p class="c4-description-summary">Updates file properties, including name, description, tags, and collections.</p>
<details class="faq-item c4-tool-description">
<summary class="faq-header" aria-label="Full description for update_file_properties">Full description</summary>

<pre class="faq-answer c4-description-text">Updates file properties, including name, description, tags, and collections. The name can have up to 255 characters, and the file extension is preserved unless you specify otherwise. The description can have up to 256 characters. You can add or update up to 100 tags.</pre>
</details>
</div>

<div data-tool-name="update_folder_properties" data-tool-class="write">
<code>update_folder_properties</code>
<p class="c4-description-summary">Updates folder properties, including name, description, tags, and collections.</p>
<details class="faq-item c4-tool-description">
<summary class="faq-header" aria-label="Full description for update_folder_properties">Full description</summary>

<pre class="faq-answer c4-description-text">Updates folder properties, including name, description, tags, and collections. The name can have up to 255 characters and must not include /, \, ., .., or leading or trailing spaces. The description can have up to 256 characters. You can update up to 100 tags.</pre>
</details>
</div>

<div data-tool-name="update_hub" data-tool-class="write">
<code>update_hub</code>
<p class="c4-description-summary">Updates the title and description of a hub.</p>
</div>

<div data-tool-name="update_metadata_template" data-tool-class="write">
<code>update_metadata_template</code>
<p class="c4-description-summary">Updates a metadata template by scope and template_key using atomic schema operations (for example, addField, editField, and removeField).</p>
</div>

<div data-tool-name="upload_file" data-tool-class="write">
<code>upload_file</code>
<p class="c4-description-summary">Uploads a new file to Box.</p>
</div>

<div data-tool-name="upload_file_version" data-tool-class="write">
<code>upload_file_version</code>
<p class="c4-description-summary">Uploads a new file version by providing the entire file contents to update an existing file in Box.</p>
</div>

<div data-tool-name="who_am_i" data-tool-class="write">
<code>who_am_i</code>
<p class="c4-description-summary">Returns detailed information about the currently authenticated Box user.</p>
</div>

This provider-published list describes the server’s tools. Authorization and feature access can reduce the tools available on your connection.

These lists use a conservative permission policy. Read requires a provider read-only hint or a reviewed Paperclip read rule. Evidence that an action changes data or submits information elsewhere puts it in Write. Write also includes actions we cannot verify as read-only. Read describes the reviewed evidence; it does not guarantee that an action has no side effects. A connected account can group actions differently.

Some listed tools are Off by default and need an administrator to enable them. This list does not establish which tools your account can use.



### Connection policies

Discovered actions become active under the connection’s existing policies. Review the list after each refresh. You can set any tool to Ask first or Off. File changes are not always recoverable from Paperclip; use Box’s trash and version history for recovery.

## Box connector FAQ

### Can I require approval for changes?

Set actions that change data to Ask first to require human approval of each call or Off to prevent calls. Allowed actions run without approval. Read and Write grouping is separate from these settings.

### What can agents reach in Box?

Agents can reach files, folders and shared content the authorizing Box account can open, subject to enterprise policies. Paperclip has no folder picker.

### What do I need before connecting?

A Box administrator must enable enterprise AI access and create the OAuth integration. Register Paperclip’s callback URI and select the Manage AI scope. Use an account with access to the intended content.


Ways to connect

- Use your own OAuth app
  - Register an OAuth app with Box, then enter its client ID and secret.

Server: `https://mcp.box.com`

[Box connector](https://docs.paperclip.ing/connectors/box/)

[Set action permissions](https://docs.paperclip.ing/connectors/action-permissions/)

## Related connectors

- [Google Drive](https://paperclip.ing/product/connectors/google-drive/): Search and read files and create or copy files.
- [Cloudinary](https://paperclip.ing/product/connectors/cloudinary/): Find media assets and update their metadata and tags.
- [Google Workspace Search](https://paperclip.ing/product/connectors/google-workspace-search/): Search across Gmail, Drive, Calendar and Chat.

## Give your agents Box.

Join the Paperclip waitlist to connect Box and choose what your agents can do.

[Join the waitlist](https://paperclip.ing/waitlist/)