Box MCP. Manage your entire enterprise document lifecycle in conversation.
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 connects your AI agent directly to your enterprise cloud content management platform. You manage files, folders, and metadata through natural conversation, eliminating the need to navigate complex UIs.
It lets you list all users, check who has access to specific folders, locate documents based on custom tags, or even create new folder structures without leaving your chat window.
What your AI agents can do
Create folder
This tool creates a new, empty folder within your Box structure.
Get file info
Retrieves the specific details about a single file, such as its size or modification date.
Get folder collaborations
Lists all users and groups that have been granted access permissions to a specified folder.
Find specific files across the platform using full-text search combined with filters like file extension or custom tags.
List all items, including their names, sizes, and modification dates, within any given Box folder, even deep nested ones.
Determine precisely which users or groups have been granted viewing, editing, or ownership rights on a specified folder.
Make brand-new folders within the existing Box structure using a parent ID or root path.
Retrieve a list of every active user account across your entire enterprise organization.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Box: File & Folder Operations (7 Tools)
These tools give your agent the power to manage all core Box functions, from creating folders to searching deep document archives.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Box on Vinkius019d7561create folder
This tool creates a new, empty folder within your Box structure.
019d7561get file info
Retrieves the specific details about a single file, such as its size or modification date.
019d7561get folder collaborations
Lists all users and groups that have been granted access permissions to a specified folder.
019d7561get folder info
Gets general details about a specific folder, like its parent ID or creation date.
019d7561list folder items
Retrieves the names, sizes, and types of all files and subfolders inside a specified Box location.
019d7561list users
Pulls a list of every individual user account active in your organization's Box setup.
019d7561search content
Searches across all documents and folders for content that matches specific keywords or filters.
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,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ 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
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 7 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
The Old Way: Manual Content Auditing
Right now, finding out who has access to a critical folder requires logging into the web interface. You click 'Manage Permissions,' then you have to scroll through long lists of names and groups. If that folder contains subfolders, you repeat this whole process for every single nested directory.
With this MCP, your agent handles it all. Just ask: 'Who can access the Q3 Reports folder?' And boom. You get a clean list of owners and viewers instantly, regardless of how deep that folder structure goes.
Access Control Management with Box
Before this MCP, checking permissions meant navigating to the folder's settings pane, finding the 'Collaborators' tab, and visually counting names. If you needed an overview of all users in your company, you had to leave the document environment entirely and go to a separate user management panel.
Now, asking for collaboration data or pulling the full roster of users is one command. It keeps your workflow contained inside your chat window, turning tedious administrative work into a simple conversation.
What you can do with this MCP connector
Need to work with content stored in a large enterprise system? This MCP connects your AI agent directly to Box, letting you manage files and collaboration data using plain language. Instead of opening the web portal and clicking through menus just to find metadata or check permissions, you ask your agent.
You can search across massive document archives for specific tags or file types. The system handles all the complexity: it identifies which folders exist, lists their contents recursively, tracks who has viewed what, and even creates new folder structures on demand. Since Vinkius hosts this MCP in its catalog, you connect once from any compatible client—Claude, Cursor, Windsurf, etc.—and instantly gain control over your entire Box environment without needing developer credentials or complex API calls.
019d7561-dbbe-711e-8360-5cc1e06a5173 
How Box MCP Works
- 1 First, you ask your AI agent to perform an action, like 'List the contents of the Project Alpha folder.'
- 2 The MCP translates that request into multiple internal calls—checking the folder's existence and retrieving all nested items.
- 3 Your agent receives a structured list of names, sizes, and types, presenting it back to you in plain text.
The bottom line is, your agent talks to Box using natural language commands instead of requiring manual navigation or scripted API calls.
Who Is Box MCP For?
This MCP is for the Operations Manager who has to audit access controls across dozens of departments. It's for the Legal professional needing to query documents based on retention policies, and the IT Admin managing user roles and permissions at scale.
Needs to quickly list items in a large repository or check which departments share access to sensitive project folders.
Must audit file metadata and user permissions to ensure documents adhere to specific retention policies before an expiration date.
Handles user lifecycle management, needing to retrieve the full list of active employees or check collaboration settings for critical shared drives.
What Changes When You Connect
- Stop manually clicking through folder trees. You can ask the agent to list items using
list_folder_itemsand get a structured report immediately. - When you need governance data, use
get_folder_collaborationsto see who has access to sensitive materials without opening any permission tabs. - Need to find one specific contract from last year? Run the
search_contenttool. It filters across all documents for keywords and metadata, far faster than manual searching. - Manage user accounts directly by calling
list_users. You get a clean roster of every active employee without logging into the admin console. - Don't waste time creating folders manually. Use the
create_foldertool to generate required organizational structure instantly via chat.
Real-World Use Cases
Auditing access for legal discovery
A Compliance Officer needs to know if a specific set of client folders are restricted. Instead of checking permissions on every folder manually, they ask the agent to run get_folder_collaborations on all relevant directories and get one consolidated list.
Onboarding a new department
The Operations Manager needs a consistent structure for the new team. They prompt the agent, which uses create_folder repeatedly to build out the required nested directory hierarchy automatically.
Finding historical documents by tag
A researcher needs all contracts related to 'Project Chimera' from 2023. They use the agent with search_content, filtering specifically for PDF files and the keyword 'Chimera,' getting immediate results.
Understanding project scope
A team lead wants to know how big a folder is without downloading it. They ask the agent, which uses list_folder_items and compiles the total size of all content in the 'Marketing Assets' folder.
The Tradeoffs
Using multiple tools sequentially
Trying to list items by calling list_folder_items, then separately running get_file_info on the first item, and finally checking permissions with get_folder_collaborations. This is slow and requires many steps.
→ Let your AI agent handle the sequence. You ask it one question—'What are the top 3 files in this folder, and who can edit them?' The agent orchestrates the necessary calls internally for you.
Ignoring metadata filters
Running a basic search that returns thousands of results, forcing the user to manually filter by date or document type.
→
Always tell your agent to use search_content and include specific metadata filters. For example: 'Find all contracts created in 2023 with PDF extension.'
Assuming folder structure
Trying to access a resource path that doesn't exist, leading to dead ends or permission errors.
→
First, call get_folder_info or list_folder_items on the parent directory to confirm the exact name and ID of the folder you need before proceeding.
When It Fits, When It Doesn't
Use this MCP if your job involves governance: checking who has access to what, auditing document structures, or querying deep archives based on metadata. This is about control over content. Don't use it if all you need is simple file transfer—if you just want to move a folder from one place to another without needing to know its contents or permissions, stick with a dedicated file sync tool. You also don't need this if your primary task is writing code; in that case, focus on IDE-native tools. But if your work involves coordinating across multiple documents and teams using Box as the source of truth, this MCP is mandatory.
Common Questions About Box MCP
How does the Box MCP help with large file searches using search_content? +
The search_content tool reads across all content. You can narrow results by filtering for specific extensions (like .pdf or .xlsx) and keywords, making huge archives manageable.
Can I use the Box MCP to see who owns a folder? +
Yep. The get_folder_collaborations tool lists every user with access rights to that specific folder, showing their roles like 'Viewer' or 'Co-owner.'
How do I use the create_folder tool in the Box MCP? +
You instruct your agent to call create_folder, providing either a desired name and an optional parent folder ID. It builds the structure for you.
What if I need user names that aren't tied to files? Can list_users do that? +
Yes, list_users pulls a comprehensive list of every active enterprise user within your Box account. It’s great for roster building or auditing.
When I use get_file_info, what kind of metadata can my agent retrieve for a single file? +
The tool retrieves detailed information about the file, including its size, creation dates, and modification timestamps. This is crucial when you need to audit files or check compliance records that rely on specific data points.
Does list_folder_items handle deep folder structures or only the immediate contents? +
It lists all items within a specified Box folder ID. You can programmatically use this tool by feeding the returned IDs back into itself to achieve full recursive traversal of nested folders.
If my agent tries to run get_folder_info on a restricted directory, how does the system handle permissions? +
The MCP returns an explicit permission failure error. This means your AI client recognizes access limitations immediately and can prompt you for alternate paths or necessary elevated credentials.
When using search_content, is there a way to filter results by file type or specific metadata fields? +
Yes, the tool allows filtering by common extensions like PDF, DOCX, and XLSX. You can also refine searches based on other available metadata filters for highly targeted retrieval.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.