# Box MCP for AI Agents AI Agent Connect

> Box MCP. Manage your enterprise cloud files, folders, and team permissions using natural language. Connect your Box account to your AI client to search for documents, organize directories, and handle file metadata without switching tabs. This tool lets you handle folder orchestration, collaborate with team members by assigning roles, and search for specific files across your entire account using simple keywords.

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

## Description

Connect your Box account to any AI agent and take full control of your cloud content management and enterprise collaboration workflows through natural conversation. Instead of clicking through endless folders, you just tell your AI where things are. It acts like a digital librarian for your company's files, allowing you to query your entire storage system without the usual friction of manual navigation. You can ask it to find a specific invoice from last year, see who has access to a project folder, or update file descriptions on the fly. It handles the tedious stuff like inviting team members with specific roles to ensure everyone has the right level of access. Because Vinkius hosts this Connector, you can plug it into your existing workflow and keep your focus on the work that actually matters. It turns a messy cloud storage system into a searchable, manageable library that responds to your questions in real time. You no longer have to worry about where a document is saved or who has permission to see it, because your AI keeps those details organized for you. Whether you are managing a massive archive or a small set of active project files, you get a consistent way to interact with your data using plain English. It takes the complexity out of enterprise storage and puts the information exactly where you need it.

## Tools

### create_collaboration
Invite team members to a folder with specific roles like editor or viewer. This makes it easy to manage permissions without manual dashboard entries.

### create_folder
Build out new directory structures in your Box account. This helps you maintain a clean and organized file hierarchy.

### delete_file
Remove individual files from your cloud storage. Use this to quickly clear out old documents or duplicates.

### delete_folder
Delete entire folders and their contents using a recursive flag. This is the fastest way to wipe out an entire project directory.

### get_file_info
See the size, version history, and parent folder for any specific file. This provides full context on document history and location.

### get_folder_info
Get details on folder creators, modified dates, and parent paths. Use this to audit folder metadata and organization.

### list_folder_items
View every file and folder inside a specific directory. This is perfect for seeing exactly what is contained in a project folder.

### search_content
Find specific items across your entire account using keywords. This is your primary way to discover files when you don't know the exact path.

### update_file
Change a file's name or update its description. This helps you keep your file names consistent and your metadata accurate.

### get_current_user
Pull profile details for the currently authenticated user. Use this to verify who is currently interacting with the account.

## Prompt Examples

**Prompt:** 
```
Find all folders related to Project X.
```

**Response:** 
```
I've searched your Box account and found the following folders related to Project X:

| Folder Name | ID | Last Modified |
| :--- | :--- | :--- |
| Project X - Assets | 99283 | 2026-07-01 |
| Project X - Planning | 88271 | 2026-06-28 |
| Project X - Final Reports | 77261 | 2026-07-05 |

Would you like me to list the items inside any of these?
```

**Prompt:** 
```
Who has access to the 'Q3 Planning' folder?
```

**Response:** 
```
I've checked the permissions for the 'Q3 Planning' folder (ID: 55432). Here are the current collaborators:

* **Sarah Jenkins** (Editor)
* **Mark Thompson** (Viewer)
* **Elena Rodriguez** (Editor)

Would you like to invite anyone else or change their roles?
```

**Prompt:** 
```
Rename the 'Old_Draft.pdf' in the 'Archive' folder to 'Final_Draft_v1.pdf'.
```

**Response:** 
```
I've successfully updated the file name in your Box account. 

**Action Complete:**
* **Old Name:** Old_Draft.pdf
* **New Name:** Final_Draft_v1.pdf
* **Location:** /Archive

Is there anything else you need help with?
```

## Capabilities

### Find specific files using keywords
Search your entire cloud library to locate documents instantly without knowing their exact path.

### Create and organize new folder structures
Build out new directories and maintain a clean file hierarchy through natural language commands.

### Manage team access and roles
Invite collaborators to specific folders and assign roles like editor or viewer automatically.

### Retrieve detailed file metadata
Get version history, file sizes, and parent folder details for any document in your account.

### Update file names and descriptions
Rename files and modify their metadata on the fly without opening individual documents.

## Use Cases

### Finding a lost invoice
A user asks for 'April invoices' and the agent finds three matching files, providing the metadata for the correct one instantly.

### Onboarding a new hire
An admin asks the agent to give a new employee editor access to the 'Marketing Assets' folder, automating the permission request.

### Auditing permissions
An IT lead asks who has access to a specific folder and the agent retrieves the full list of collaborators and their roles.

### Cleaning up old data
A user asks the agent to delete all folders inside a 'Drafts' directory from 2022, clearing out old workspace clutter in one go.

## Benefits

- Stop hunting for files by using `search_content` to find anything in your library instantly.
- Control access precisely by using `create_collaboration` to set editor or viewer roles for specific folders.
- Keep your data organized by using `create_folder` and `list_folder_items` to build clean directory structures.
- Get full context on documents by using `get_file_info` to see version history and metadata.
- Update your records quickly by using `update_file` to rename documents or change descriptions without opening them.

## How It Works

The bottom line is you get a way to talk to your Box storage like a human instead of navigating a file tree.

1. Subscribe to the Box MCP on the Vinkius Marketplace.
2. Generate an Access Token or Developer Token from the Box Developer Console.
3. Connect your token to your AI client to start managing your cloud files.

## Frequently Asked Questions

**Can the Box MCP help me find files with specific keywords?**
Yes, it can search your entire Box account for files and folders using any keywords you provide. This makes it much faster to find documents than clicking through folders manually.

**How do I give a teammate access to a folder using the Box MCP?**
You can simply ask your AI client to invite a teammate to a specific folder and tell it what role they should have, such as editor or viewer.

**Can I see the version history of a file?**
Yes, the Connector can retrieve detailed metadata for any file, which includes its version history, file size, and the parent folder it lives in.

**Does the Box MCP work with my existing folders?**
Yes, it connects directly to your current Box account and interacts with your existing folder structures and files.

**Is it safe to manage permissions this way?**
Yes, the Connector uses your authenticated credentials to perform actions, ensuring that all changes to permissions and files follow your account's security rules.

**Can I use this to organize my company's cloud storage?**
Absolutely. It is designed to help manage enterprise-grade content, allowing you to build out folder structures and manage team access via natural language.

**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').