# Box MCP for AI Agents AI Agent Connect

> Box MCP lets you manage your enterprise cloud content directly through your AI agent. You can search for files, manage folder permissions, and organize metadata without leaving your chat window. It turns your AI into a hands-on assistant for your Box account, making it easier to find and share documents across your organization.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_sZxaYYdILkmNS9CsBbYAfqKO1qZRuv23U1H4ARTe/ai-agent-connect
- **Tags:** file-sharing, enterprise-content, cloud-governance, workflow-automation, secure-storage, file-lifecycle

## Description

Box MCP connects your enterprise account to any AI agent so you can manage cloud content through natural conversation. Imagine you need to find a specific contract from three years ago that's buried in a messy folder structure. Instead of clicking through dozens of nested directories in a web browser, you just ask your AI agent to find it. This connection lets your agent do the heavy lifting for you. You'll be able to pull up file details, check who has access to shared folders, and even update metadata on the fly. It's like having a personal assistant who knows exactly where every document lives and has the permissions to move them around. Whether you're an IT admin auditing user groups or a legal pro hunting for retention-heavy files, this connection brings your content into your primary workspace. You can get up and running quickly by adding this to your Vinkius catalog, which simplifies how you connect these types of enterprise tools to your favorite AI clients. It moves the work from manual navigation to conversational commands. You no longer have to worry about the friction of a complex web interface. You just tell your agent what you need, and it handles the navigation, searching, and permission checking for you. It removes the need to keep multiple tabs open or remember complex folder paths. It turns a static storage box into a dynamic, searchable knowledge base that lives inside your chat.

## Tools

### create_collaboration
Requires the folder ID, the user's email (login), and an assigned role (e.g., "editor", "viewer", "previewer").

Share a folder with a collaborator

### create_folder
Make a new folder in a specific location or the root. This lets you organize your storage on the fly.

### delete_folder
If the folder is not empty, you must set the recursive flag to true to delete all its contents.

Delete a folder from Box

### get_file_info
Get the metadata and details for a specific file. You can use this to see file stats and custom tags.

### search_content
Find files using text, extensions, or folder locations. This is your primary way to locate documents across the platform.

### update_file
Can be used to rename the file or update its description.

Update file attributes and metadata

### get_current_user
Use this to verify the current identity.

Retrieve current Box user details

### delete_file
Delete a file from Box

### get_folder_info
Pull specific details about a folder's properties. Use this to check the basic status of a directory.

### list_folder_items
See what's inside a folder including sizes and types. This helps you get an overview of your directory contents quickly.

## Prompt Examples

**Prompt:** 
```
Search for all contracts expiring in Q2 2026.
```

**Response:** 
```
Found 14 files matching 'contract':

| File Name | Category | Size | Expiration Date |
| :--- | :--- | :--- | :--- |
| MSA-ClientAlpha-2024.pdf | Legal/Contracts | 2.3 MB | 2026-06-30 |
| SaaS-License-BetaCorp.docx | Procurement | 890 KB | 2026-04-15 |

Showing top 5 of 14.
```

**Prompt:** 
```
Who has access to the Board Reports folder?
```

**Response:** 
```
**Board Reports** folder collaborators:

* **CEO Jane Smith** (Co-owner)
* **CFO Mike Chen** (Editor)
* **Legal Team** (Viewer, 5 members)
* **External Auditor Group** (Viewer, 2 members, link expires Dec 2026)

**Total:** 10 unique users.
```

**Prompt:** 
```
List the 10 largest files in the Engineering folder.
```

**Response:** 
```
Top 10 files by size in **Engineering**:

1. `architecture-diagram-v12.fig` (245 MB)
2. `load-test-results-march.zip` (189 MB)
3. `database-backup-staging.sql` (156 MB)

**Total folder size:** 2.1 GB across 847 files.
```

## Capabilities

### Find specific files using full-text search
Your agent scans your content to locate specific documents based on keywords or extensions.

### Create new folders in specific locations
Tell your agent to build out a new directory structure in your cloud storage instantly.

### Check who has access to a shared folder
Query the list of collaborators to see exactly who has permission to view or edit content.

### List all users in an enterprise account
Get a full list of enterprise users to manage or review your organization's members.

### Apply custom metadata to your files
Update and query custom metadata tags to make your documents more searchable and organized.

### Download and upload files to your cloud
Move files in and out of your Box account using simple conversational commands.

## Use Cases

### Finding expiring contracts
A legal worker asks for all contracts expiring in 2026 and gets a list of files with their metadata.

### Permission Audits
An IT admin asks who can see the "Board Reports" folder to ensure only the right people have access.

### Data Organization
An ops lead asks the agent to create a new folder for "Q3 Projects" and move five specific files into it.

### Large File Retrieval
A designer asks for the 10 largest files in the "Engineering" folder to check storage usage.

## Benefits

- Stop clicking through deep folder trees by using `search_content` to find files instantly.
- Audit your security by checking `get_folder_collaborations` to see exactly who has access to what.
- Keep your data organized by using `create_folder` and `list_folder_items` to structure your storage.
- Make files more discoverable by applying custom metadata with `get_file_info` and related actions.
- Manage your team more easily by using `list_users` to see who's in your enterprise account.

## How It Works

The bottom line is you get a conversational interface for your entire Box file system.

1. Connect your Box enterprise account to the Connector via the Vinkius dashboard.
2. Grant the necessary permissions for your AI agent to access your files and folders.
3. Ask your agent to perform tasks like searching for documents or listing folder contents.

## Frequently Asked Questions

**Can I use the Box MCP to find specific files?**
Yes, you can ask your agent to search for any file using keywords, file types, or specific folder locations. It finds the documents for you so you don't have to click through directories.

**Does Box MCP let me see who can access my folders?**
Yes, you can ask your agent to check the collaborators on any folder. It will provide a list of everyone who has access, which is great for security audits.

**Can I create folders using the Box MCP?**
Yes, you can tell your agent to create new folders in specific locations or at the root of your account to stay organized.

**How do I manage users with Box MCP?**
You can ask your agent to list the users in your enterprise account. This makes it easy to see who is part of your organization without opening admin panels.

**Can I search for specific file types like PDFs?**
Yes, the Connector supports filtering by file extensions. You can ask for all PDFs, Word docs, or Excel files in a specific folder.

**Is Box MCP good for legal teams?**
It's excellent for legal teams who need to perform rapid audits of permissions or find specific contracts buried in large archives.

**What authentication does Box use?**
Box supports Client Credentials Grant (CCG) for server-to-server auth. Create a Custom App in the Box Developer Console, select 'Server Authentication (Client Credentials Grant)', and get the Client ID and Client Secret.

**Can I search file contents?**
Yes. The search_content tool uses Box's full-text search engine. It searches inside documents, presentations, spreadsheets, and PDFs.

**Does it support metadata queries?**
Yes. The query_metadata tool supports Box metadata queries using SQL-like syntax against metadata templates applied to files and folders.

**How do I find my Box Access Token?**
Log in to the [**Box Developer Console**](https://app.box.com/developers/console), select your app, and generate a Developer Token or use the OAuth settings to obtain an Access Token.

**Can I search for content via AI?**
Yes! The `search_content` tool allows your agent to find files and folders across your entire account matching specific keywords.

**How do I share a folder programmatically?**
Use the `create_collaboration` tool and provide the folder ID, the recipient's email (login), and their assigned role (e.g., 'editor', 'viewer').