# Dropbox MCP > Dropbox MCP connects your AI agent directly to your cloud storage. It lets you manage files and folders via natural conversation—no clicking, no navigating. You can list directory contents, search for specific documents by name, check exact usage limits, audit shared access permissions, and even create new links or folder structures without ever leaving the chat window. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** file-sync, cloud-storage, file-management, directory-services, shared-links ## Description Connecting your Dropbox account to an AI agent gives you full control over file management through conversation. Instead of manually clicking through folders and cross-referencing metadata, you just ask what you need. For example, if you need a list of all files tagged 'Q3' in the Marketing folder, or if you want to know which shared directory is governed by specific organizational permissions, your agent handles it instantly. This level of deep file auditing is usually buried in complex admin consoles. It lets you go beyond simple retrieval; you can audit who has access to a shared space, calculate how many bytes of storage are used versus the total capacity, and even create new folders or share links on the fly. Because Vinkius hosts this MCP, your agent gets instant access to all these operations in one place. You control your cloud assets using natural language commands. ## Tools ### get_space_usage Retrieves the current byte usage metrics against your total cloud storage capacity. ### get_metadata Fetches comprehensive technical data for any specific file or folder object. ### list_folder Lists the contents of a directory, showing names, tags (file/folder), sizes, and modification times. ### search_files Searches for files by name across your indexed representations. ### list_shared_links Generates a list of all existing public or restricted shared links you manage. ### list_shared_folders Lists the directories that have been explicitly designated as shared among users. ### get_account Provides current account information, including user name, email, and account type details. ### list_mountable_folders Reveals shared folders that are available to be mounted by the system for synchronization. ### create_folder Creates a new folder at any specified path within your cloud storage structure. ### move_file Moves or renames an existing file or folder to a new location. ### copy_file Duplicates an existing file or folder into a specified target location. ### create_shared_link Generates and shares a public link for either a specific file or entire folder. ## Prompt Examples **Prompt:** ``` List files in my '/Projects/2024' folder ``` **Response:** ``` Retrieving items from '/Projects/2024'... I found 5 files: 'Plan.pdf', 'Budget.xlsx', and 3 images. Would you like to see the metadata for the planning document? ``` **Prompt:** ``` Search for any files containing 'invoice' in their name ``` **Response:** ``` Searching for 'invoice'... I found 3 matches: 'Invoice_Jan.pdf', 'Invoice_Feb.pdf', and 'Old_Invoices.zip'. Which one would you like more details on? ``` **Prompt:** ``` Show me my Dropbox storage usage ``` **Response:** ``` Retrieving storage info... You are using 1.2 GB of your 2.0 GB total capacity (60% used). You have approximately 800 MB of space remaining. ``` ## Capabilities ### Audit Storage Usage Get precise metrics showing how much storage space you've used compared to your total allocation. ### Discover Files and Folders Search for content or list the entire contents of any specific directory path, including names, tags, and modification dates. ### Manage Sharing Permissions List all existing shared links or folders, and generate new public links for files or directories. ### Inspect Object Metadata Retrieve detailed technical data about any file or folder, including unique IDs, hashes, and precise byte sizes. ### Organize Structure Create new folders at specific paths or move/rename existing files and directories within Dropbox. ## Use Cases ### Finding a compliance document from six months ago A Project Manager needs the final draft of the Q3 budget, but it could be in any department's shared drive. Instead of manually browsing through 'Finance,' then 'Drafts,' and hoping to find the right folder, they ask their agent to `search_files` for 'Q3 Budget Final.' The system returns a list of matches instantly. ### Restructuring an entire project directory An Ops Engineer needs to move all assets from the old '/Legacy' folder into the new '/Archive' location. Instead of selecting files one by one, they ask the agent to `move_file` for every item in a batch, ensuring perfect structure integrity. ### Checking if a client link is still active A Knowledge Worker receives an email with a shared folder link and needs to confirm its permissions. They ask the agent to `list_shared_folders` in that area, which confirms whether the directory is governed by cross-tenant organizational rules. ### Setting up a new client workspace A Developer needs to set up a dedicated folder structure for a new project. They ask the agent to `create_folder` in three nested parts ('/Clients/ClientX/ProjectAlpha'), and the entire directory tree is established immediately. ## Benefits - Stop jumping between Dropbox and chat apps. You can list files using `list_folder` and then get the full technical details with `get_metadata`—all in one conversation. - Never worry about hitting a storage limit again. Use `get_space_usage` to instantly check your remaining capacity against your total allocation. - Need to audit team access? List all shared directories using `list_shared_folders`, or review every link with `list_shared_links` without opening any web console. - The workflow is faster: Instead of manually creating folders and then uploading, you tell the agent to `create_folder` at a full path, and it handles the structure instantly. - When you need to share something, don't guess. Use `create_shared_link` to generate an explicit URL for files or folders immediately. ## How It Works The bottom line is that your cloud storage becomes an interactive database, accessible through simple conversation rather than complex web forms. 1. Subscribe to this MCP and provide your Dropbox Generated Access Token. 2. Connect the MCP to your preferred AI client (Claude, Cursor, Windsurf, etc.). 3. Tell your agent exactly what you want—for example, 'List all files in my /Finance/2024 folder'—and receive the results immediately. ## Frequently Asked Questions **How do I check my total Dropbox storage usage with Dropbox MCP?** You use the `get_space_usage` tool. Simply ask your agent to 'Show me my current cloud storage consumption.' It returns a direct metric comparing your used bytes to your total capacity. **Can I list all shared folders with Dropbox MCP?** Yes, the `list_shared_folders` tool retrieves every folder that has been designated for sharing. This helps you audit who has access to specific team areas. **What is the difference between listing and searching in Dropbox MCP?** Listing (using `list_folder`) shows everything currently *in* a specified folder, including names and tags. Searching (`search_files`) uses indexing to find files across your whole account based on keywords. **How do I get technical data about one file using Dropbox MCP?** You use the `get_metadata` tool. This function goes beyond simple names, providing hashes, unique IDs, and exact byte sizes for deep auditing. **Does Dropbox MCP let me create folders at any path?** Yes, you can use the `create_folder` tool to build complex directory structures. You just need to provide the full, desired file path in your prompt.