# Zoho WorkDrive MCP > Zoho WorkDrive connects your cloud storage directly to your AI agent. It lets you manage files, folders, and team workspaces using natural conversation. Need to delete a draft folder or check who has editing rights on a client presentation? Your agent handles the file system commands instantly. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** file-management, team-folders, cloud-storage, permission-management, content-collaboration, file-sharing ## Description Managing shared documents across multiple platforms is tedious. You spend time opening Zoho WorkDrive in your browser just to rename an asset, generate a secure link for a contractor, or figure out which folders belong to which project team. This MCP lets you skip all that clicking. You tell your agent what needs doing—'Create the Q3 Marketing Assets folder and list the top 5 files inside.' The AI handles the file system commands immediately. You can audit who accessed a document, change permissions for a new contractor, or delete outdated drafts, all through conversation. Because sensitive credentials pass through a zero-trust proxy within Vinkius, your keys never sit on a disk; they only move when needed. This means you get full control over your digital workspace without compromising security. ## Tools ### create_folder Creates a brand new folder in your storage. ### create_share_link Generates a unique, external link that can be shared outside the team. ### delete_file Deletes either an individual file or an entire folder structure. ### get_file_metadata Retrieves specific details about any file or folder, like size or owner. ### get_my_profile Pulls basic profile information for the user connected to the account. ### list_files Lists all files and folders in a specified directory. ### list_file_permissions Shows who has access and what rights (read/write) they have on a specific file or folder. ### list_recent_files Retrieves a list of files that were accessed by the team recently. ### list_share_links Shows you all external share links created for a file or folder. ### list_team_folders Lists available workspaces or shared directories for your organization. ### list_teams Retrieves a list of all defined teams within the Zoho platform. ### rename_file Changes the name of an existing file or folder. ## Prompt Examples **Prompt:** ``` Create a new folder named 'Q4 Marketing Assets' inside the root directory and list the contents to confirm it was created. ``` **Response:** ``` I have successfully created the 'Q4 Marketing Assets' folder in your root directory. The directory now contains 4 items, including your new folder, 'Sales Reports', and 'Team Guidelines.pdf'. ``` **Prompt:** ``` Generate a new external share link for the 'Client Proposal v2.pdf' file so I can send it to the external vendor. ``` **Response:** ``` I have created a new public share link for 'Client Proposal v2.pdf' named 'Vendor Access'. You can copy the URL here: [Link]. The file now has 2 active external share links. ``` **Prompt:** ``` Show me the workspaces for the 'Engineering Team' and check who has access permissions to the 'Architecture Specs' folder. ``` **Response:** ``` I've retrieved the workspaces for the Engineering Team. For the 'Architecture Specs' folder, there are 3 users with access: Sarah (Admin), John (Editor), and the 'Guest Contractors' group (Viewer). Would you like to modify any of these permissions? ``` ## Capabilities ### Audit team file activity Get details about who viewed or modified files and folders recently. ### Structure the directory tree Create, rename, and delete entire folders to keep your project assets organized. ### Control access permissions List or modify user rights on specific files or entire team workspaces. ### Securely share content Generate external links for files, and track how many times they've been accessed. ### View user data Pull basic profile information about team members connected to the workspace. ## Use Cases ### Project kickoff and setup The Project Lead needs a clean starting point. They ask their agent to first run `list_teams` to find the correct group, then tell the agent to execute `create_folder` for 'Q4 Assets' inside that team’s workspace. This establishes the entire structure in two steps. ### Client audit before handoff The Business Administrator needs to prove compliance. They ask their agent to run `list_file_permissions` on a folder, checking every user and group to ensure only authorized editors have access. ### Sharing assets with external partners A Content Manager finishes a presentation. Instead of downloading it and emailing it separately, they ask the agent to `create_share_link` for the file so the client can review it without needing a full account. ### Cleaning up old drafts The team needs to clear out outdated materials. The agent first uses `list_files` in the 'Archive' folder, then runs `delete_file` on anything older than six months. ## Benefits - Stop manually tracking files. Use `list_recent_files` to see exactly what the team accessed last week without opening a single dashboard tab. - Maintain order effortlessly by using `rename_file`. Instead of clicking through folders, just tell your agent to rename 'Draft v1' to 'Final Client Signoff'. - Control who sees sensitive documents. Run `list_file_permissions` to verify that only the finance department can view salary reports. - Share files securely and track usage via `create_share_link`. You get a unique link, and you know exactly how many people used it. - Scale your automation by combining this MCP with others. Your agent can first use `list_teams` to find the right department, then use `create_folder` within that team's space. ## How It Works The bottom line is, you control complex file system tasks by simply talking to your AI agent. 1. Subscribe to this MCP and enter your Zoho API credentials. 2. Connect your account using OAuth 2.0 flow from any compatible client. 3. Start telling your agent what to do—'List all folders under the Engineering team'—and get the results back. ## Frequently Asked Questions **How do I check permissions using list_file_permissions? ** You ask your agent to run `list_file_permissions` on the specific file or folder. It returns a clear breakdown of which users or groups have what level of access (read, write, etc.). **Can I list all my team's folders with list_team_folders? ** Yes, you use `list_team_folders` to see every available workspace. This helps you figure out where a specific project archive is stored. **How do I rename a file using rename_file? ** You just give the agent two pieces of information: the current name and the new name, along with the exact location. It runs the change directly on Zoho WorkDrive. **What if I want to see files that were recently updated? ** Use `list_recent_files`. This tool pulls a list of the most accessed assets, so you don't have to guess where your team might have left something. **Does create_share_link make the link public? ** No. You must specify the necessary access controls when running `create_share_link`. The agent will guide you on setting up secure, limited-use links for clients. **How do I use get_file_metadata to inspect a file's details?** It returns specific data about any given file or folder, including its size, creation date, and owner. This is critical for validating the path before you run commands like renaming or deleting something. **Before starting a complex workflow, how do I use list_users?** This tool pulls a directory of all active user profiles in your Zoho WorkDrive instance. You get names and IDs right away, which is necessary for targeting specific people or setting up permissions. **When should I use delete_file?** You run this tool when you need to permanently remove files or entire folders from your storage. Be careful: running this command deletes the data immediately, so always confirm the exact path first. **How do I obtain my Zoho WorkDrive Client ID and Secret?** Go to the [**Zoho API Console**](https://api-console.zoho.com/), register a new 'Server-based Application', and generate your credentials by providing the required redirect URI. **Can the AI agent permanently delete files from my WorkDrive?** Yes, the agent has access to the `delete_file` tool. Use it with caution as it will remove the specified file or folder from your storage.