# Dropbox MCP MCP > Dropbox MCP lets you manage all your cloud files right from your agent client. You can list entire folder structures, search for specific documents by name, audit shared links, and check usage limits without clicking through a single UI page. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** file-sync, cloud-storage, file-management, directory-services, shared-links ## Description Need to sort through massive amounts of shared data? This connector gives your AI client full control over your Dropbox storage. Instead of logging into the website and manually navigating folders, you just talk to your agent. Your agent handles everything—from listing out every item in deeply nested directories to checking if a document is actually shared with certain people. For example, if you need an audit trail showing who has access or how much space is left on a team drive, the agent figures it out instantly. Because Vinkius keeps all credentials passing through a zero-trust proxy, your keys never sit on disk, keeping things secure while you work. When this Dropbox MCP connects to other tools, like a billing system or a CRM, your AI client can build automations that span multiple platforms and manage files across the whole enterprise stack. ## Tools ### get_account Get current account info ### get_metadata Get file/folder metadata ### get_space_usage Get storage space usage ### list_folder Analyzes contents returning names, tags (`folder`/`file`), sizes, and server-modified times. List files and folders in a directory ### list_mountable_folders List mountable shared folders ### list_shared_folders List all shared folders ### list_shared_links List all shared links ### search_files Search files by name ## 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 Shared Folder Permissions List all shared folders and audit which specific nested directories are governed by organizational permissions. ### Perform Deep Directory Listing Analyze the contents of a folder, returning names, tags, size information, and when the server last modified each item. ### Search Files by Name Execute structural queries to find files quickly using indexed representations. ### Monitor Storage Capacity Check your physical storage limits, reporting both the used bytes and the total available capacity. ## Use Cases ### Auditing a Team Project A project manager needs to know the status of all documents in the 'Q3 Reports' folder, including who has access and if there are any hidden shared folders. They ask their agent, which uses `list_shared_folders` and `list_folder`, getting an instant report. ### Finding a Lost Contract A knowledge worker knows they saved the 'Vendor Agreement' somewhere in 2023 but can't remember where. They use `search_files` and get back three potential hits, letting them pick the right one. ### Capacity Planning An ops team member needs to report on storage usage for the month-end meeting. Running `get_space_usage` provides a definitive byte count, preventing unexpected overages. ## Benefits - Stop jumping between tabs. You can search for files using `search_files` and get the results immediately in your chat, without leaving your workflow. - Track team storage limits instantly. Use `get_space_usage` to know if you're hitting capacity before a critical deadline. - Audit permissions fast. The agent lists all shared folders using `list_shared_folders`, letting you see who has access across the organization. - Get granular details on any file. If you need to know the exact size or unique ID of a document, run `get_metadata` for absolute precision. - Keep track of links. Instead of hunting through email chains, use `list_shared_links` to see every active link you've created. ## How It Works The bottom line is you tell your agent what files or folders you need; it handles connecting to Dropbox and retrieving the data. 1. Subscribe to this MCP in Vinkius. 2. Paste your Dropbox Generated Access Token into the platform's settings. 3. Ask your agent client to perform a file action, like 'List all folders under my Projects directory.' ## Frequently Asked Questions **Can my agent list files in a specific Dropbox folder?** Yes. Use the 'list_folder' tool. Provide the folder path (use an empty string for the root). The agent will return an array of items including names, types, and modification dates. **How do I find a file by its name through natural conversation?** Use the 'search_files' tool. Provide your query string, and the agent will execute a structural match against your indexed Dropbox files, returning the most relevant results. **Can I check how much storage space I have left via the agent?** Absolutely. The 'get_space_usage' tool retrieves your physical allocation blocks. It will show you exactly how many bytes are used versus your total account capacity. **When I use `get_metadata`, what precise technical details about a file or folder do I get?** It returns granular bindings, including the unique ID, cryptographic hash, and exact byte size of the object. This is useful for developers who need to validate schemas or check data integrity. **How does `list_shared_folders` help me audit team permissions?** It isolates all shared folders under specific organizational or cross-tenant rules. This allows your agent to map out exactly which directories are governed by external team access, making auditing straightforward. **If I run `list_folder` on a directory that doesn't exist or is restricted, what error handling do I get?** The agent reports the failure immediately and specifies whether the issue was due to an invalid path or insufficient permissions. This prevents ambiguous errors and lets you know exactly why the operation failed. **What data points does `list_shared_links` provide, and how do I track them?** It retrieves all exposed URLs, clearly noting whether the link is public or restricted. This allows your agent to verify if a shared file can be downloaded over the sharing APIs. **What information does `get_account` provide about my connection?** The tool resolves core user context, giving you the account name, email address, and account type. It's a quick way to verify that your agent is operating under the correct permissions.