# Dropbox Paper MCP for AI Agents MCP > Dropbox Paper lets your agent handle all collaborative document tasks, giving you full control of content creation and file organization through natural conversation. You can create new Markdown documents, search across your entire content library for specific snippets, or manage shared links and folders without touching the web interface. ## Overview - **Category:** collaboration - **Price:** Free - **Tags:** collaborative-editing, markdown-support, team-workspace, document-creation, content-management ## Description Need to work with complex, shared documentation but hate jumping between tabs? This MCP connects your Dropbox Paper account directly to your agent, letting you treat your entire document structure like a giant notepad. You can ask your AI client to create brand-new papers using basic Markdown formatting or find exactly what you're looking for by running deep text searches across every file in your workspace. It handles the messy parts of collaboration—like moving files from 'Drafts' into 'Final Assets', renaming folders, or checking if you've hit your storage limit. You even get full visibility into who has access to what and can manage shared links on demand. If you already use Vinkius for connecting various services, this MCP adds the necessary structure layer for all your team’s writing and project documentation. ## Tools ### list_files Lists all files and Paper documents within a specified Dropbox folder path so you can browse your content. ### list_files_continue Continues listing contents when a folder has too many items for one request, ensuring you see everything. ### search_files Performs full-text search across all Dropbox Paper documents to find content snippets based on keywords. ### get_metadata Retrieves detailed structural information for a single file or Paper document, including its unique ID and last modified date. ### create_document Generates a brand-new Dropbox Paper document artifact using structured Markdown content you provide. ### move_file Changes the location or name of an existing file or Paper document to keep your folder structure clean. ### delete_file Permanently removes a specified file or Paper document from your account. ### create_folder Builds a new, empty folder structure at any specific path within Dropbox. ### get_account Retrieves the authenticated profile identity details to verify your current permissions and account context. ### get_space_usage Checks your remaining Dropbox storage space and overall quota limit for billing awareness. ### list_shared_folders Shows all folders that have been shared with or created by you, giving an overview of team access. ### list_shared_links Retrieves a list of public and restricted sharing links attached to files or entire folders. ## Prompt Examples **Prompt:** ``` Search all my papers for anything mentioning the budget cuts and list them by date. ``` **Response:** ``` Found 3 mentions: * **Q4 Budget Plan v2.paper**: Mentioned June 15, 2024 (Section 3.1) * **Team Meeting Notes.paper**: Mentioned May 2, 2024 (Action Items list) * **Finance Summary.paper**: Found on record, last updated: Jun 1, 2024 Do you need the full text snippet for any of these? ``` **Prompt:** ``` I need to create a new document for the launch plan. Make it in /Projects/Alpha and include three sections: Goals, Timeline, and Assets. ``` **Response:** ``` Done! I created '/Projects/Alpha/Launch Plan v1.paper'. It's structured with the following markdown headings: # 🎯 Goals (Add your key objectives here) # 🗓️ Timeline (Milestones and dates) # 🖼️ Assets (Required resources and links) You can edit this right away in Dropbox Paper for collaboration. ``` **Prompt:** ``` Move the 'Old Strategy.paper' file from /Drafts to /Archive/2023/ ``` **Response:** ``` **File moved successfully!** The document is now located at: `/Archive/2023/Old Strategy.paper`. * **Original Path**: `/Drafts/Old Strategy.paper` * **New Path**: `/Archive/2023/Old Strategy.paper` The document's ID and all existing sharing links remain intact. ``` ## Capabilities ### Create new documents Generates brand-new Paper documents instantly, taking Markdown input to create a fully rendered file. ### Search document content Runs deep full-text searches across every single Paper document in your entire Dropbox repository. ### Manage folders and files Lists, creates, moves, renames, or deletes any file or folder within specified paths. ### Audit file metadata Retrieves detailed structural information for specific documents, including ID hashes and owners. ### Check storage status Provides real-time data on your account's current usage and remaining quota space. ### Control shared access Lists all folders shared with you or by you, and helps manage public or restricted sharing links. ## Use Cases ### Archiving completed reports A PM needs to move 15 finalized project reports from the 'Working Docs' folder into '2024 Archive'. Instead of manually selecting and moving each file, they simply ask their agent to use 'move_file' on all files matching a certain date criteria. The system executes the atomic routing operation instantly. ### Gathering competitive insights A content strategist needs to find every mention of 'AI ethics guidelines' across 50 different departmental papers. They prompt their agent with a deep search query, and the system uses 'search_files' to retrieve all relevant snippets, saving hours of manual reading. ### Onboarding new team members A manager needs to ensure a new hire has access to specific documentation. They ask their agent to list all shared folders using 'list_shared_folders', verifying that the necessary departmental guides are visible and properly permissioned. ### Verifying document completeness A developer needs to confirm if a critical asset, like the V1 branding guide, exists in the root folder. They use 'list_files' and 'get_metadata' to verify both its existence and its file ID for integration testing. ## Benefits - Stop wasting time navigating the web interface. You can create a brand-new document using 'create_document' directly through conversation. - Deep search across all content is instant. Instead of manual searches, use 'search_files' to pull exact snippets from every Paper doc in your library. - Keep your workspace clean. Use 'move_file' or 'rename_file' to sort drafts into archives without clicking through folders. - Never lose track of assets again. The 'list_shared_folders' tool shows you exactly what team members have given you access to. - Stay compliant and aware. Quickly check your storage limits using 'get_space_usage' before starting a massive project. - Need to audit permissions? Use 'get_account' to verify current identity bindings, knowing exactly what your agent can touch. ## How It Works The bottom line is that your AI client manages complex document and folder operations entirely through conversation, making manual web clicks unnecessary. 1. First, subscribe to this MCP on Vinkius and enter your Dropbox Generated Access Token from your App Console settings. 2. Your agent then uses natural language prompts—like 'list all files in /Project Alpha'—to interact with the document system. 3. The system returns structured data detailing the file paths, metadata, or content snippets you requested, allowing your workflow to continue immediately. ## Frequently Asked Questions **How do I use the Dropbox Paper MCP to find content across my entire team’s documentation?** You can run a deep, full-text search across every single document in your workspace. This lets you pull out specific snippets or keywords from hundreds of files instantly, saving hours of manual searching. **Does the Dropbox Paper MCP help me organize my project folders?** Yes, absolutely. You can ask your agent to list all current folders and files, then tell it to move or rename items into a new structure using simple commands, keeping your workspace clean. **How do I create a brand-new Paper document without opening the web interface?** You just ask your agent. You can provide the raw Markdown content and specify the exact path and file name where you want it created, getting a fully rendered doc instantly. **Can the Dropbox Paper MCP help me manage who has access to my files?** It does. You can list all folders shared with or by you, giving you visibility into team access. It even helps manage those public or restricted sharing links. **What if I need to know what documents exist in a specific folder path?** You use the MCP to list all files and papers within that exact directory structure. This gives you a clear, structured inventory of everything currently housed there.