Box MCP for AI Agents. Find, organize, and audit every file in your company's content library.
Box MCP connects your AI client directly to the Box cloud content management system. It lets you manage files, folders, permissions, and metadata using natural conversation instead of navigating complex UIs or digging through folder IDs. You can search company-wide for documents, check who has access, or create new structure elements—all hands-free.
Give Claude and any AI agent real-world access
The agent lists all items inside a specific Box folder, providing names, sizes, and dates modified.
You can ask the agent to create new folders within your account or retrieve details about existing ones.
The system performs a full-text search, filtering results by file type (like PDF or DOCX) and specific metadata tags.
You can list who has been given access to a folder and what their current permission level is.
The agent pulls an up-to-date roster of all enterprise users within your Box account, including group memberships.
Ask an AI about this
Waiting for input…
What AI agents can do with Box MCP: 7 Available Tools
Use these tools to orchestrate complex file management tasks, from navigating deep folder structures to auditing user access across the entire content library.
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 MCPList Folder Items
Retrieves a detailed listing of every file or folder contained within a specified Box directory.
Get Folder Info
Fetches specific details about an entire folder, such as its total size and creation...
Create Folder
Allows you to build out your company's structure by generating a brand new folder at...
Get File Info
Pulls specific metadata, size, and details for any individual file within Box.
Search Content
Searches through documents and files using keywords, narrowing results by file type...
Get Folder Collaborations
Lists every person or group who has been granted access to a specific folder and what rights they possess.
List Users
Generates an up-to-date list of all active employee accounts within the Box organization.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
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 each 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 5,200+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,200+ others, all in one place
- Add new capabilities to your AI anytime you want
- Connections are secured and governed automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog weekly
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 each call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
The Struggle of Manual Content Discovery Solved with Vinkius AI Gateway
Today, finding a specific file feels like archaeology. You open Box, click through the main departmental folders, then into subfolders that might have been renamed months ago. If you need to check permissions for 50 different documents, you're opening 50 tabs and clicking 'Manage Access' repeatedly. It’s slow, tedious, and easy to miss a key document buried three levels deep.
With this MCP, the process changes entirely. You just tell your agent what you need—like 'Show me all final marketing reports from last quarter.' The system instantly runs `search_content` across all relevant areas and presents a filtered list, complete with metadata, saving you the headache of manual folder navigation.
Get Full Control Over Content Access
Before this MCP, checking who could view 'Board Minutes' required opening the folder and clicking into the collaboration settings. If you wanted to know if an external auditor had access *and* what their specific role was, it meant multiple manual steps.
Now, running `get_folder_collaborations` gives you a single, clean readout of every user, their group membership, and their exact permissions level—all in seconds. You get immediate visibility into your content governance.
What your AI can actually do with this
This MCP gives your agent direct control over your Box enterprise account. Think of it as having a virtual assistant that knows the exact location and details of every document in your organization’s cloud storage.
Instead of manually opening folders, navigating directory trees, or remembering file IDs, you just talk to your AI client. You can ask it to list all documents related to 'Q3 marketing' or check if a specific folder needs restricted access. The agent handles the deep dives, whether that means listing contents inside a shared folder, running full-text searches across years of files, or applying custom metadata tags.
Because this MCP manages everything from user rosters to complex collaboration rules, you get a complete picture of your company's knowledge base without ever leaving your chat window. It makes the huge catalog of content manageable, letting you focus on answering questions instead of finding the right file first.
019d7561-dbbe-711e-8360-5cc1e06a5173 Here's how it actually works
The bottom line is that your agent talks to Box like it's its own native system, giving you structured data without any manual clicks.
You tell your AI client what you need. For example, 'Find all legal contracts that expire next year and who owns the folder.'
The agent translates that request into specific Box actions, like using search_content and then calling get_folder_collaborations on the results.
Your AI client gives you a direct answer, listing the files found, showing their metadata, and confirming the owners and access levels.
Who is this actually for?
This MCP is for anyone drowning in corporate documents—the legal team trying to locate old agreements, the IT admin managing user access, or the operations specialist who needs quick answers about company history. If you spend time clicking through folder menus just to find one document, you need this.
You check if a specific set of client files has required metadata tags attached and list all users who have access to the restricted folders.
You search for agreements matching certain keywords or dates, then use get_folder_collaborations to verify that only authorized parties can view them.
You list all users and groups using the roster tool, helping you audit permissions and manage who has access across different departments.
What Changes When You Connect
Stop clicking through directories. You can use search_content to find a document anywhere—even if you only remember a keyword or the general topic—without knowing its exact folder path.
Audit access instantly. Instead of opening multiple files, you run get_folder_collaborations on a folder name and get an immediate list of every user and their precise permissions (viewer, editor, etc.).
Maintain structure on the fly. Need a new place for Project Phoenix documents? Use create_folder to build it instantly while your agent handles all the underlying ID management.
Quickly understand file scope. The get_file_info tool lets you check the size, type, and last modified date of any document without opening it or downloading it first.
Get a clear employee view. Use list_users to get an official roster of all employees in your organization, which is perfect for compliance audits or onboarding tasks.
See it in action
Locating a forgotten contract
A lawyer needs an agreement from 2021 regarding 'Client Beta' that was stored in the defunct 'Marketing Assets' folder. They ask their agent to run search_content for 'Beta client contract'. The agent finds three matching files, lists them by size and metadata, saving hours of manual searching.
Onboarding a new team
The department head needs to ensure the new hires have access only to their specific project folders. They use list_users to get the employee list, then ask the agent to check permissions on key project areas using get_folder_collaborations, ensuring nothing is over-shared.
Preparing for an audit
The compliance officer must prove that all HR records are stored in a single, restricted area. They ask the agent to run list_folder_items on the HR folder and also use get_file_info on each item to verify proper metadata tags (e.g., retention policy applied).
Project cleanup
The project manager realizes two teams are using different folders for the same kind of data. They ask the agent to get_folder_info on both areas, comparing total file counts and sizes, which immediately shows them where they need to consolidate.
The honest tradeoffs
What to watch out for, and the recommended way to handle each one.
Forgetting folder IDs
Manually typing or guessing the deep, complex ID for a folder like '2024/Legal/Client Alpha/Drafts' is error-prone and slow.
Just ask your agent by name: 'List items in the Drafts folder.' The agent uses list_folder_items internally, so you never have to worry about IDs.
Scope creep during searches
Searching only by keyword often returns irrelevant files because it misses necessary context like 'Must be a PDF' or 'Only from the Finance department'.
Use search_content and add filters, specifying both keywords AND required file extensions (e.g., 'Show me all PDFs matching budget').
Missing visibility checks
Assuming that because a document exists in Box means everyone can see it. You might accidentally give out sensitive data.
Always verify access using get_folder_collaborations before sharing anything, ensuring you know exactly who has viewer or editor rights.
When It Fits, When It Doesn't
Use this MCP if your primary job involves navigating, auditing, and managing structured corporate knowledge. If you need to find a document by name, check permissions on a folder, or list out users, this is what you want. It handles the entire lifecycle of file content—creation, storage, access control, and retrieval.
Don't use this if your goal is something outside the core data structure, like sending an email message (use a Messaging MCP) or running complex mathematical calculations on raw numbers (use a Finance/Math MCP). If you just need to know who works at the company, list_users handles that. But if you need to access and manipulate content within those users' shared documents, this is your tool.
Questions you might have
How do I use the Box MCP to find all documents? +
You run search_content by telling your agent what you are looking for and specifying filters like file type or date range. This searches across everything in the account, not just one folder.
Can I use Box MCP to list all employees? +
Yes, calling list_users pulls an up-to-date roster of everyone in your organization and their basic group memberships for auditing purposes.
Is the Box MCP better than just browsing folders? +
Absolutely. Browsing requires you to know the folder path; using this MCP allows you to ask natural language questions (e.g., 'Show me Q3 legal files') and lets the agent figure out the path for you.
What if I want to create a new project area? +
You use create_folder to build it. You simply tell your agent where it should go, and it handles creating the folder structure in Box.