# Shimo Docs MCP > Shimo Docs connects your AI client to a professional office suite for document management and collaboration. Your agent treats your files—Word, Excel, PPT—like an extension of conversation. Instead of clicking through menus, you instruct your agent to list all documents, create new spreadsheets in specific folders, or export complex reports into PDF format. It's full-featured team documentation control, accessible via natural language prompts. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** office-suite, team-collaboration, file-management, cloud-docs, real-time-editing ## Description This MCP lets your agent handle the heavy lifting of professional document management. Shimo Docs is a major collaborative platform, and by connecting it to your agent, you stop navigating web interfaces just to manage files. You simply talk to your AI client—whether that's Claude or Cursor—and tell it what you need done with your team’s documents. Your agent acts like a real-time assistant inside the system, listing every file, creating new collaborative drafts, and even bringing in external data for analysis. If you're managing project documentation or financial records, you can ask your agent to import content or export finished work into standard formats like docx or pdf. This makes complex team workflows feel as simple as a conversation. Since Vinkius manages the connection, all these functions are available through one unified interface. Your agent handles everything from browsing folder structures to listing organization users and reviewing audit logs for compliance. You get complete control over your documents without ever leaving your chat window. ## Tools ### create_file Generates a brand new file within Shimo Docs. ### export_file Converts an existing Shimo document into a different format, like PDF or docx. ### get_file Retrieves specific details about a single file by its ID. ### get_folder_content Lists every file and sub-folder contained within a specified directory. ### get_org_info Retrieves general organizational details about the workspace setup. ### import_file Brings external content or documents into the Shimo Docs system for collaboration. ### list_audit_logs Pulls a record of actions taken in the workspace, useful for security checks. ### list_files Returns a comprehensive list of all documents and files accessible in your account. ### list_folders Outputs the full hierarchical structure, showing all available folders. ### list_users Provides a list of every user belonging to the organization or workspace. ## Prompt Examples **Prompt:** ``` List all my collaborative documents on Shimo. ``` **Response:** ``` I've retrieved your Shimo documents. You have 5 active files, including 'Marketing Strategy 2026' and 'Budget Planning'. Would you like to view the details of any of them? ``` **Prompt:** ``` Create a new spreadsheet titled 'Q2 Expenses' in folder 'Finance'. ``` **Response:** ``` Done! I've created the spreadsheet 'Q2 Expenses' inside the 'Finance' folder. You can now start collaborating on it. File ID: SH-8821. ``` **Prompt:** ``` Export the document 'Project Roadmap' to PDF. ``` **Response:** ``` I've processed the export for you. Your document 'Project Roadmap' is now ready in PDF format. You can download it here: [link]. ``` ## Capabilities ### Discovering File Locations List all available files, folders, or specific organizational details across the entire workspace. ### Creating and Modifying Documents Generate entirely new collaborative documents, including spreadsheets and presentations, within designated folders. ### Content Movement Import external content into Shimo Docs or export existing files into common formats like PDF. ### Managing File Structure Retrieve details about specific documents, get a list of all contents inside a folder, or delete outdated files. ### Administrative Oversight List organization users and check the audit logs to track who accessed which document and when. ## Use Cases ### Preparing for an Investor Pitch A PM needs three things: 1) The latest budget figures (in 'Finance'), 2) A list of all user sign-offs (via `list_users`), and 3) A consolidated PDF summary. They ask their agent to find the necessary files, gather the info, and export a single document combining everything. ### Onboarding a New Client A Knowledge Worker has raw market research (a zip file). Instead of manually uploading it, they tell their agent to `import_file` into Shimo Docs. The agent then creates a new collaborative document and organizes the data for the client team. ### Post-Mortem Incident Review An Admin Team Lead needs to know who accessed sensitive system documents after an incident. They prompt their agent to `list_audit_logs`, which immediately provides a detailed, time-stamped report of user activity. ### Auditing Project Scope Creep A manager wants to know if any unauthorized files exist in the main project directory. They instruct their agent to `list_files` and then use that list to check for documents created outside of the established 'Scope' folder. ## Benefits - You bypass manual web navigation. Instead of clicking through multiple folder layers to find a file's status, simply ask your agent to list all accessible documents or retrieve details about a specific project sheet using `get_file`. - The document lifecycle is simplified. You can use `import_file` to bring in external research data and then instruct the agent to create a new collaborative spreadsheet around it, eliminating copy-pasting into a blank canvas. - Compliance checks become instant. Need to know who viewed that contract last week? Use `list_audit_logs` to pull a detailed report of activity without manually running reports in a separate admin panel. - Collaboration is streamlined across formats. You can tell your agent to export the final presentation into PDF format using `export_file`, ensuring the correct, locked-down version is delivered immediately. - Organization becomes visible at a glance. If you're lost in the file structure, ask the agent to run `list_folders` and get a complete map of the entire workspace hierarchy. ## How It Works The bottom line is that once connected, you manage complex documents by talking to your AI client instead of clicking buttons in an app. 1. Subscribe to this MCP on Vinkius, then enter your Shimo App ID and App Secret. 2. Connect your preferred AI client (Claude, Cursor, etc.) through the Vinkius marketplace. 3. Give your agent a direct instruction, like 'List all files in the Marketing folder,' and watch it retrieve the data. ## Frequently Asked Questions **How do I start using Shimo Docs with my AI client?** You must first subscribe to this MCP and enter your specific Shimo App ID and App Secret. Once authenticated through Vinkius, you can use any prompt to begin file operations. **Can I ask Shimo Docs to create a new spreadsheet?** Yes. You simply instruct your agent using the `create_file` tool and specify that you want a spreadsheet in the desired location. It handles the creation automatically. **What if I need to check who has access to a file?** You can run `list_users` or use the administrative tools available through this MCP, which lets you audit organization membership and activity logs for security checks. **Does Shimo Docs help me combine external data into my documents?** Yes. You use the `import_file` tool to bring in content from other sources, allowing your agent to incorporate that external information directly into a new collaborative document. **Is exporting a file done automatically?** No, you must specifically ask your agent to use the `export_file` tool and tell it what format (like PDF) you need. It won't guess; you have to give the command.