# Box MCP > Box MCP lets you control enterprise content management and collaboration directly through your AI client. Forget clicking through dozens of tabs; this connector treats your entire cloud drive like a natural conversation. You can list folder contents, find specific files using semantic keywords, or grant precise permissions to teammates—all without leaving the chat window. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** file-sharing, enterprise-content, cloud-governance, workflow-automation, secure-storage, file-lifecycle ## Description Managing documents across an organization is usually a mess of browser tabs and permission requests. This MCP lets you handle all that chaos by talking to your cloud content hub. You get full control over your company's files and folders right through natural language prompts. Need to know who has access to the Q3 budget folder? Just ask. Want to find that specific invoice from last year, even if you don't remember the file name? Tell your agent what it was about, and it searches everything. It handles everything from listing all contents in a directory structure to adding new team members with precise roles like 'editor' or 'viewer'. When you connect this MCP through Vinkius, your AI client acts as a dedicated digital librarian for your entire corporate network. ## Tools ### create_collaboration Grants specific users access to a folder, setting their role as editor, viewer, or previewer. ### create_folder Builds a new, designated container for files within your Box account structure. ### get_current_user Retrieves the profile details and identity information for the user running the command. ### delete_file Removes an individual file from its current location in the cloud drive. ### delete_folder Deletes a folder and all of its contents recursively, permanently removing the directory structure. ### get_file_info Pulls deep metadata for a file, including its version history, size, and parent folder ID. ### get_folder_info Gathers details about a directory, like who created it and when it was last modified. ### list_folder_items Lists every single file and folder contained within a specified parent folder. ### search_content Searches the entire Box account for files and folders based on keywords, even if you don't know their IDs. ### update_file Renames a file or changes its description and metadata attributes. ## Prompt Examples **Prompt:** ``` List all items in my Box root folder. ``` **Response:** ``` I've retrieved your root directory. You currently have 5 items, including 'Project Alpha' (Folder ID: 123) and 'Quarterly Reports'. Which one should we explore for details? ``` **Prompt:** ``` Search for files containing 'Invoice' in my Box account. ``` **Response:** ``` Searching... I found 3 matching files: 'Invoice_April_2026.pdf' (ID: 456), 'Old_Invoice.docx', and 'Pending_Invoice'. Would you like the high-fidelity metadata for the April invoice? ``` **Prompt:** ``` Invite @user1 to folder '123' as an editor. ``` **Response:** ``` Collaboration created! I've successfully invited @user1 to collaborate on specified folder (ID: 123) with the 'editor' role. They will receive a notification to join. Need help with any other access controls? ``` ## Capabilities ### Discover Files and Folders Search across all content using keywords to find specific files or navigate the directory structure. ### Manage Team Access Invite users and set their roles (editor, viewer) for specific folders to control who sees what data. ### Maintain File Records Get deep metadata about any file, including its size, version history, or when it was last modified. ### Structure and Clean Up Content Create new folders or delete files and entire directories programmatically to keep the content hub tidy. ### Audit User Identity Check who is currently logged in and retrieve basic account details for reporting purposes. ## Use Cases ### Auditing Compliance An IT admin needs to verify all department heads have the correct viewing rights on a sensitive HR folder. They ask the agent to use `list_folder_items` and then cross-reference `get_file_info` for every file, ensuring no unauthorized users exist. ### Project Kickoff A project manager starts a new initiative. They tell the agent to run `create_folder` for 'Q4 Launch' and then use `create_collaboration` to add three key team members as editors immediately. ### Lost Document Recovery A knowledge worker needs a presentation from last year about the European market. They don't know where it is, so they prompt the agent to `search_content` using keywords like 'European sales 2023'. The agent delivers the exact file link. ### Cleaning Up Archives An admin needs to close out a defunct project. They ask the agent to locate the old folder structure, use `get_folder_info` to confirm nothing is needed, and then execute `delete_folder`. ## Benefits - Finding specific documents is fast. Instead of browsing, you just tell the agent to search for files using `search_content`, and it returns exact matches across the whole account. - You gain total control over access rights. Use `create_collaboration` to invite a teammate and assign them only 'viewer' status, preventing accidental changes while keeping them in the loop. - Never lose track of document versions again. The agent can pull detailed metadata using `get_file_info`, showing you version numbers and who made which change. - Keep your structure clean by automating directory management. You can use `create_folder` to build a new project area or `delete_folder` when the project wraps up. - The ability to list everything inside a folder using `list_folder_items` lets you audit an entire section of content without needing multiple manual calls. ## How It Works The bottom line is you tell your AI client what to do, and it executes complex file system commands on Box for you. 1. First, subscribe to this MCP on Vinkius and get your developer or access token from the Box Developer Console. 2. Next, connect your AI client (like Cursor or Claude) using that token. Your agent can now communicate with the cloud service. 3. Finally, use natural language prompts—for example, 'Find all reports created last month'—and watch your agent perform the actions directly in the chat. ## Frequently Asked Questions **How do I find a file using the search_content tool?** You just ask your agent to search by keywords, even if you don't know the specific ID. It searches all content for matching terms and returns a list of candidates. **Can I use create_collaboration to restrict access?** Yes. You specify the folder and then choose an exact role—editor, viewer, or previewer—so you control exactly what level of access they get. **Does list_folder_items show me file details?** It lists all items inside a folder. If you need deeper data like version numbers or the SHA1 hash, you'll need to use `get_file_info` on that item. **What if I want to update a file name?** Use the `update_file` tool. You point it at the existing file and tell it the new name or what metadata needs changing. **If I use the delete_folder tool, do I have to worry about nested items?** Yes, you must set the recursive flag to true. If you skip that step, the MCP will not delete any contents inside the folder, preventing accidental data loss. **How do I verify my identity when using get_current_user?** It retrieves your full profile details for confirmation. This confirms exactly who's running the MCP operation right now, which is critical for compliance and auditing purposes. **What specific technical data can I retrieve with get_file_info?** The tool provides more than just metadata; you get the file size, SHA1 hash, and detailed version history. This gives your agent the full technical context of any document. **Can list_folder_items show me every item in my entire Box account?** You must use ID "0" when calling this tool for the root folder. Using '0' ensures you can see all top-level items across your whole directory structure. **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').