Skip to main content

​
Overview

The Box server securely connects AI agents to your enterprise content in Box. Built by Box, this official MCP server enables AI assistants to access files, folders, collaborate, search, and use Box AI for intelligent document queries and metadata extraction.

​
How to Add Box

1

Create Box Account

  1. Go to https://account.box.com/
  2. Sign up for a free Box account or use your existing account
  3. Upload files to your Box storage
2

Connect to Nexus

  1. Add the Box server to your Nexus environment through the server directory
  2. Authorize Box when prompted using OAuth
3

Test Connection

Start with a simple command like “Show me my box files” to verify the connection works properly.
Box uses remotely-hosted MCP server with OAuth authorization. For detailed setup instructions, visit Managing Box MCP Servers.

​
What You Can Do

File & Folder Navigation

Browse folders, list contents, and search for files and folders across your Box account

Box AI - Document Q&A

Ask questions about single files, multiple files, or entire Box Hubs using AI

Advanced Search

Search files by keywords or use SQL-like metadata queries for complex filtering

Box AI - Metadata Extraction

Extract structured or freeform metadata from documents using AI-powered analysis

​
Available Tools (11)

​
User & File Operations

Returns detailed information about the currently authenticated Box user
  • Input: None
  • Use Cases: Verify authentication, get user details
Returns content of a file stored in Box
  • Input: file_id - The ID of the file to retrieve content from
  • Use Cases: Read file contents for analysis or processing

​
Search & Navigation

Searches for folders within Box by name using keyword matching
  • Input: name - Folder name to search for
  • Use Cases: Find folders by name across your Box account
Lists files, folders, and web links in a folder
  • Input: folder_id - The ID of the folder to list contents from
  • Use Cases: Browse folder contents, navigate folder structure
Searches for files using keywords. Supports metadata filters, file extension filtering, and field selection
  • Input: query - Search query string
  • Use Cases: Find files by keywords, filter by metadata or extensions
Searches for files using SQL-like metadata queries. Supports complex filtering with parameters, field selection, and folder scoping
  • Input: query - SQL-like metadata query
  • Use Cases: Advanced file searches with metadata filtering, complex queries

​
Box AI - Question & Answer

Asks a question to a single file using Box AI
  • Input:
    • file_id - The ID of the file to query
    • prompt - Question to ask about the file
  • Use Cases: Get insights from documents, ask questions about file content
Asks a question to multiple files using Box AI
  • Input:
    • file_ids - Array of file IDs to query
    • prompt - Question to ask about the files
  • Use Cases: Get insights across multiple documents, compare information
Asks a question to a Box Hub using Box AI
  • Input:
    • hub_id - The ID of the Box Hub to query
    • prompt - Question to ask about the Hub
  • Use Cases: Query collections of content, Hub-specific insights

​
Box AI - Metadata Extraction

Extracts metadata from files using Box AI in freeform format without requiring predefined template structures
  • Input:
    • file_id - The ID of the file to extract metadata from
    • prompt - Instructions for what metadata to extract
  • Use Cases: Extract custom metadata, flexible data extraction without templates
Extracts structured metadata from files using Box AI based on either custom fields definition or an existing metadata template
  • Input:
    • file_id (required) - The ID of the file to extract metadata from
    • template_key (optional) - The key of the metadata template to use
  • Use Cases: Extract structured data based on templates, standardized metadata extraction

​
Use Cases

  • User Info: Get details about the authenticated user with who_am_i
  • Browse Content: List folder contents with list_folder_content_by_folder_id
  • Search Folders: Find folders by name with search_folders_by_name
  • Read Files: Get file content with get_file_content
  • Single File Q&A: Ask questions about a specific file with ai_qa_single_file
  • Multi-File Q&A: Get insights across multiple files with ai_qa_multi_file
  • Hub Q&A: Query Box Hub collections with ai_qa_hub
  • Freeform Extraction: Extract custom metadata with ai_extract_freeform
  • Structured Extraction: Extract template-based metadata with ai_extract_structured
Box supports OAuth authorization and provides secure access to your cloud storage. The server is remotely hosted by Box for optimal performance and security.