Box MCP. Manage your entire cloud file structure via chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Box MCP Server gives your AI client full control over your enterprise cloud content. Use it to search, manage, and govern files across your entire Box directory structure.
You can list folders, check file versions, update metadata, and invite team members with specific roles—all through natural conversation.
What your AI agents can do
Create collaboration
Adds a user to a folder and sets their role (like 'editor' or 'viewer').
Create folder
Makes a new folder structure in Box.
Delete file
Removes a specific file from Box.
Invites a collaborator to a specific folder and assigns them a role like 'editor' or 'viewer'.
Creates a new folder structure within your Box account.
Removes files or entire folders from Box. For folders, you must specify if the deletion should be recursive.
Retrieves specific metadata about a file, including its size, version history, and parent folder information.
Lists all files and folders inside a specified directory, getting metadata for every item.
Finds files and folders using keywords when you don't know their exact location or ID.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Box MCP Server: 10 Tools for File & Folder Management
These tools allow your AI client to interact with Box's core functions: managing folder structure, tracking file metadata, and controlling user permissions.
019dd0c5create collaboration
Adds a user to a folder and sets their role (like 'editor' or 'viewer').
019dd0c5create folder
Makes a new folder structure in Box.
019dd0c5delete file
Removes a specific file from Box.
019dd0c5delete folder
Deletes a folder; requires a flag if the folder contains other items.
019dd0c5get current user
Retrieves the user's current profile information in Box.
019dd0c5get file info
Gets detailed metadata for a specific file, including its size and version history.
019dd0c5get folder info
Gets details and metadata about a specific folder, like its creator and last modified date.
019dd0c5list folder items
Lists all files and folders within a specified directory.
019dd0c5search content
Finds files and folders across your whole Box account using keywords.
019dd0c5update file
Changes a file's name or updates its description.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Box, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
You're giving your AI client full control over all your enterprise stuff in Box. You can search, manage, and govern files across your whole directory structure just by talking to it. You can list folders, check file versions, update metadata, and invite team members with specific roles—all through natural conversation.
Manage Folder Access
Invite a collaborator to a folder and set their role—like 'editor' or 'viewer'—using create_collaboration.
Create New Folders
Make a new folder structure in Box with create_folder.
Delete Content
Remove a specific file using delete_file, or wipe out an entire folder with delete_folder; remember, you gotta tell it if the folder has stuff inside.
Get File Details
Fetch specific metadata for a file with get_file_info, which gives you its size, version history, and parent folder info. You can get details and metadata about a folder, like who made it and when it was last touched, using get_folder_info.
List Folder Contents
See every file and folder inside a specific directory by running list_folder_items. This gives you metadata for every item.
Search Across Content
Find files and folders using keywords across your whole Box account when you don't know their exact location or ID by calling search_content.
User Info
Check your current profile details in Box with get_current_user; you can also change a file's name or update its description using update_file.
How Box MCP Works
- 1 Subscribe to the server and get your Box Developer Token or OAuth Access Token.
- 2 Input a natural language command to your AI client (e.g., 'Find the Q3 report folder').
- 3 The agent calls the appropriate tool (
search_contentorlist_folder_items), and the results are returned to you for action.
The bottom line is: your AI client handles the API calls and data parsing, letting you manage your enterprise files with simple chat commands.
Who Is Box MCP For?
This is for Project Managers, Knowledge Workers, and IT/Admin Leads who deal with complex document structures. You're the person who gets frustrated having to switch between file explorer tabs, check permissions manually, and then search for a version of a document that someone else renamed. This tool centralizes that control.
Needs to instantly gather project files and adjust team access. For instance, they use the agent to 'Give the marketing team view access to the Q4 assets folder' via create_collaboration.
Needs to find specific internal resources without leaving their main chat window. They use search_content to locate a document by keyword, then get_file_info to verify the correct version.
Needs to audit or manage organizational file structures. They use list_folder_items or get_folder_info to map out directory contents or check creation dates across multiple folders.
What Changes When You Connect
- Manage access control instantly. Instead of going to the web portal to invite a user, just tell your agent to run
create_collaboration. They handle the role assignment (editor/viewer) for the specific folder. - Find what you need, no matter where it lives. Use
search_contentto locate a file using keywords, even if you don't know the folder ID. This is huge for discovery. - Track document changes easily.
get_file_infogives you the version history, SHA1 hash, and size of a file—all without opening the file in a browser. - Audit file structure quickly. Running
list_folder_itemslets you see everything in a folder, giving you a real-time inventory of the contents. - Avoid data loss. Use
delete_fileordelete_folderwith the correct flags. Your agent helps manage the complex deletion requirements, like the recursive flag for folders. - Know who's who.
get_current_userverifies your identity, andget_folder_infotracks who created and last modified the folder, giving you audit context.
Real-World Use Cases
Need to find a document from a specific quarter?
A knowledge worker needs the 'Q2 Budget' file, but it could be in any of the 5 project folders. Instead of manually checking each folder's contents, they ask their agent to search_content for 'Q2 Budget'. The agent returns the file ID and metadata, solving the discovery problem instantly.
Handing off a project with new team members?
A project manager needs to onboard two new team members to the 'Product Specs' folder. They simply instruct their agent to run create_collaboration twice, assigning one as an 'editor' and the other as a 'viewer'. The access is set perfectly, and they don't touch the web UI.
Document version mismatch and cleanup?
An admin lead realizes the 'Master Plan' folder has three outdated versions. They use get_file_info on the files to check the version history and find the latest approved document, allowing them to clean up the old files using delete_file.
Mapping out an entire department's file structure?
An IT lead needs to audit the 'Finance' department's file structure. They use list_folder_items on the root folder ID '0' to get a comprehensive list, and then use get_folder_info to track creation and modification dates across all subfolders.
The Tradeoffs
Manual Metadata Check
Going to the web browser, clicking into a file, and manually checking the properties panel to see the version number or file size.
→
Use get_file_info. Just ask your agent to retrieve the file details. It returns the size, SHA1 hash, and version info directly in the chat response.
Searching by Folder ID
Trying to remember the exact ID of a folder when you just know the name (e.g., 'Marketing Assets'). This is a huge time sink.
→
Use search_content. You only need to type keywords like 'Marketing Assets' into your prompt. The tool finds the item even if you don't know its ID.
Setting Permissions in Batches
Creating a spreadsheet of 50 users, then manually going into 5 different folders to assign permissions one by one.
→
Use create_collaboration. Simply list the users and the target folder ID, and your agent handles the mass permission updates with the correct role in a single call.
When It Fits, When It Doesn't
Use this MCP Server if your core job revolves around managing, auditing, or sharing files in a large, complex cloud environment like Box. You need to programmatically enforce rules, check version control, or audit permissions across many folders.
Don't use it if your workflow is simple (e.g., just sharing a single file link). In those cases, the native Box UI is faster. If your core need is to integrate Box data into another system (like a CRM), you need a specialized data pipeline tool, not just a file manager.
If you need to know what the file is (e.g., 'is this a PDF or an image?'), use get_file_info. If you need to find the file (e.g., 'where is the Q3 report?'), use search_content. The distinction is critical.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Box. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Finding the right document shouldn't require digging through five different browser tabs.
Most companies still handle document retrieval by opening the web portal, navigating through the folder hierarchy, and clicking 'Search'. This means copying names, checking IDs, and cross-referencing permissions across multiple screens. It's slow and error-prone.
With the Box MCP Server, you just tell your agent what you need—like 'Show me the latest marketing guide.' The agent uses `search_content` across your entire account, brings back the file ID, and gives you the metadata instantly. You don't leave the chat.
Box MCP Server: Control file access and structure with a few commands.
Previously, changing a team member's access meant logging into the Box UI, finding the correct folder, clicking the 'Share' button, finding the user, and selecting the right role. It's a multi-click, multi-step process.
Now, you tell your agent to run `create_collaboration`. It handles the entire process—the target folder, the user's email, and the specific role—in one go. That's the difference.
Common Questions About Box MCP
How do I find a file using the Box MCP Server's `search_content` tool? +
You simply ask your agent to search for the file using keywords. You don't need the file ID or the exact folder path. The agent runs search_content and returns a list of matching files and their metadata.
Can I use `get_file_info` to check a document's version history? +
Yes. Running get_file_info pulls the necessary metadata, including the version history, SHA1 hash, and size, letting you verify which version is the most current.
What is the difference between `list_folder_items` and `search_content`? +
Use list_folder_items when you know the exact folder ID and want to see everything inside it. Use search_content when you only know keywords and need to find something anywhere in your Box account.
How do I grant access using the `create_collaboration` tool? +
You provide the folder ID, the user's email, and the role (editor, viewer, previewer). The agent executes the call and confirms the collaboration was created.
What information does `get_folder_info` provide about a folder's creation and modification dates? +
It returns the folder's creation date, the user who created it, and the last time it was modified. This lets you track organizational changes and understand folder ownership.
How do I handle bulk deletion of contents using the `delete_folder` tool? +
You must set the recursive flag to true when using delete_folder. This ensures the tool deletes the folder and everything inside it, preventing incomplete deletions.
Can `update_file` be used to change file ownership or just metadata? +
The update_file tool only handles renaming the file or modifying its description/metadata. It does not change the file's underlying owner or access permissions.
What is the purpose of `get_current_user` when setting up workflows? +
This tool confirms the identity of the user running the agent. Running this first step verifies the authenticated user details before performing any sensitive operations.
How do I find my Box Access Token? +
Log in to the Box Developer 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').
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
NCR Voyix
Manage commerce and retail operations via NCR Voyix — track orders, sites, products, and inventory directly from your AI agent.
UKG Pro Learning
Manage employee training, courses, and learning paths via UKG Pro Learning.
Pando
Share large files and folders securely with clients using branded transfer portals and download analytics for creative teams.
You might also like
Taboola
Manage Taboola advertising campaigns, ads, and performance reports directly from any AI agent.
Livestorm
Connect your AI agent to Livestorm to manage webinars, registrations, attendees, and analytics via natural language.
DingTalk
Alibaba's B2B office platform — manage users, departments, send notifications, track attendance, and automate approval workflows.