Box MCP (Official)

Securely access files and content stored in Box through Box’s official Remote MCP server.

Overview

Box provides an official Remote MCP server (https://mcp.box.com) that enables AI agents to search, view, and manage files stored in Box, as well as leverage Box AI capabilities.

QueryPie AIP offers this official MCP server as a pre-configured Remote MCP. To set up the integration, you need to obtain a Client ID and Client Secret from the Box Developer Console.

Supported Features

The Box official MCP server supports the following features:

• File Management: View, upload, and update file properties
• Folder Management: Create folders, view details, and list contents
• Search: Keyword-based file search, metadata-based search, folder search
• Box AI: Metadata extraction (freeform and structured, including Enhanced)
• Collaboration: File comments, collaborator lists, task management
• Hubs: Create, manage, and add items to Hubs

Supported MCP Tools

User Management Tools

who_am_i

Returns profile information of the currently authenticated Box user.

File Management Tools

get_file_details

Retrieves detailed file information (name, size, created/modified dates, permissions, etc.).

get_file_content

Extracts text content from a file (under 50MB). Supports PDFs, documents, spreadsheets, presentations, code files, and more. Files without a text representation will return an error.

upload_file

Uploads a new file to Box. You can specify the target folder.

upload_file_version

Uploads a new version of an existing file. Only supports text content, same as upload_file.

update_file_properties

Updates file metadata such as name, description, tags, and collections.

Folder Management Tools

list_folder_content_by_folder_id

Lists files, folders, and web links within a folder. Use ID "0" for the root folder.

get_folder_details

Retrieves detailed folder information.

create_folder

Creates a new folder.

update_folder_properties

Updates folder metadata such as name, description, tags, and collections.

Search Tools

search_files_keyword

Searches for files by keyword. Supports extension filters, date ranges, and metadata filters.

search_folders_by_name

Searches for folders by name. Can be scoped to a specific parent folder.

search_files_metadata

Searches for files using SQL-like metadata queries.

Box AI Tools

ai_extract_structured_from_metadata_template

Extracts structured metadata from files based on an existing metadata template.

ai_extract_structured_from_metadata_template_enhanced

Performs enhanced extraction based on metadata templates using the Enhanced Extract Agent. More expensive than the standard tool and only used when explicitly requested.

ai_extract_structured_from_fields_enhanced

Extracts structured metadata using the Enhanced Extract Agent based on custom field definitions. Supports string, float, date, enum, and multiSelect types. More expensive than the standard tool and only used when explicitly requested.

Collaboration Tools

list_file_comments

Lists comments on a file.

create_file_comment

Adds a comment to a file.

list_item_collaborations

Lists collaborators for files and folders. Can query up to 10 items simultaneously.

list_tasks

Lists tasks assigned to a file.

Hubs Tools

list_hubs

Lists accessible Hubs.

get_hub_details

Retrieves detailed information about a specific Hub.

get_hub_items

Lists items (files, folders, web links) within a Hub.

create_hub

Creates a new Hub.

add_items_to_hub

Adds files, folders, and web links to a Hub.

update_hub

Updates the title or description of a Hub.

How to Obtain Client ID / Secret

Step 1: Access Box Developer Console

1. Go to the Box Developer Console .
2. Log in with your Box account.

Step 2: Create an OAuth App

1. Click Create New App.
2. Select Custom App and choose User Authentication (OAuth 2.0) as the authentication method.
3. Enter an app name (e.g., QueryPie AIP).
4. After creating the app, navigate to the Configuration tab.

Step 3: Configure OAuth Settings

1. In OAuth 2.0 Redirect URI, enter the OAuth callback URL provided by AIP.
2. Under Application Scopes, check Write all files and folders stored in Box.
3. Copy the Client ID and Client Secret.

Step 4: Configure in AIP

1. In the QueryPie AIP admin panel, select the Box MCP (Official) item.
2. Enter the Client ID and Client Secret you obtained.
3. Complete the integration setup.

References

• Box Official Documentation: Remote Box MCP server 
• Box Developer Console