Box Community MCP Server Box

🚀 MCP Server Box

MCP Server Box is a Python project that integrates with the Box API to perform various operations, such as file search, text extraction, AI-based queries, and data extraction. It leverages the box-sdk-gen library and offers a set of tools for interactively handling Box files and folders.

The Model Context Protocol (MCP) is a framework designed to standardize the way models interact with multiple data sources and services. In this project, MCP is used to facilitate seamless integration with the Box API, enabling efficient and scalable operations on Box files and folders. The MCP Server Box project aims to provide a powerful and flexible solution for managing and processing Box data using advanced AI and machine learning technologies.

✨ Features

Implemented Tools

box_who_am_i

Retrieve current user information and check the connection status.

Returns: A string of user information

box_authorize_app_tool

Initiate the Box app authorization process.

Returns: An authorization status message

box_search_tool

Search for files in Box.

Parameters:

• query (str): The search query
• file_extensions (List[str], optional): Filtered file extensions
• where_to_look_for_query (List[str], optional): Search locations (NAME, DESCRIPTION, FILE_CONTENT, COMMENTS, TAG)
• ancestor_folder_ids (List[str], optional): Folders to search within

Returns: Search results

box_read_tool

Read the text content of a Box file.

Parameters:

• file_id (str): The ID of the file to read

Returns: File content

box_ask_ai_tool

Ask a question to Box AI about a file.

Parameters:

• file_id (str): File ID
• prompt (str): The question to ask the AI

Returns: AI response

box_search_folder_by_name

Locate a folder by its name.

Parameters:

• folder_name (str): The name of the folder

Returns: Folder ID

box_ai_extract_data

Use AI to extract data from a file.

Parameters:

• file_id (str): File ID
• fields (str): Fields to extract

Returns: Extracted data in JSON format

box_list_folder_content_by_folder_id

List the contents of a folder.

Parameters:

• folder_id (str): Folder ID
• is_recursive (bool): Whether to list recursively

Returns: Folder contents in JSON format, including ID, name, type, and description

📦 Installation

Prerequisites

• Python 3.13 or higher
• Box API credentials (client ID, client secret, etc.)

Steps

1. Clone the repository:

git clone https://github.com/box-community/mcp-server-box.git
cd mcp-server-box

2. Install uv if not already installed:

   • MacOS + Linux

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

   • Windows

   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   

3. Create and set up the project:

   • MacOS + Linux

   # Create a virtual environment and activate it
   uv venv
   source .venv/bin/activate
   
   # Lock dependencies
   uv lock
   

   • Windows

   # Create a virtual environment and activate it
   uv venv
   .venv\Scripts\activate
   
   # Lock dependencies
   uv lock
   

4. Create a .env file in the project root directory and add your Box API credentials:

BOX_CLIENT_ID=your_client_id
BOX_CLIENT_SECRET=your_client_secret

💻 Usage Examples

Running the MCP Server

To start the MCP server, run the following command:

uv --directory /path-to-the-project/mcp-server-box run src/mcp_server_box.py

Using Claude as a Client

1. Edit your claude_desktop_config.json file

code ~/Library/Application\ Support/Claude/cla