# Files.com MCP > Files.com MCP Server lets you manage enterprise files using your AI client. You can list directories, check file metadata, get download links, and audit activity logs. Use it to track who accessed what, manage folder structure, and verify permissions across your secure cloud storage. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** file-transfer, secure-storage, audit-logs, cloud-sync, file-metadata, collaboration ## Description **Files.com MCP Server - Secure File Storage & Sync** Your AI client handles all your enterprise file management inside Files.com. You'll list folders and directories at any path to map the entire storage hierarchy. You can get detailed metadata for any single file using its full path. You'll use `list_users` to get a list of every registered user account. You'll use `list_user_groups` to see all the predefined organizational groups. You can check the access rights and permissions for any file or folder using `list_permissions`. To track who can access what, you'll use `list_users` and `list_user_groups` to monitor account access. You'll use `get_file_details` to retrieve size, type, and the last modified date for a specific file. You can programmatically create a new folder at a specified location with `create_folder`. You'll use `delete_file` to delete an unnecessary file or folder. You can list all files and directories at a given path to map out your whole storage structure using `list_folders`. You'll use `list_activity_history` to query historical and real-time logs, tracking every file upload, download, and deletion over a set time range. You'll get a full picture of your data governance by checking the file metadata and permission distribution. ## Tools ### create_folder Creates a new folder at a specified location. ### delete_file Deletes a specific file or folder from the system. ### get_file_details Retrieves detailed metadata for a single file using its full path. ### list_activity_history Fetches a record of file actions, including uploads, downloads, and deletions, over a given time range. ### list_folders Lists all folders and directories at a given path within the Files.com system. ### list_permissions Displays the access rights and permissions for a specified file or folder. ### list_user_groups Lists all predefined organizational groups within the account. ### list_users Retrieves a list of all individual user accounts registered in Files.com. ## Prompt Examples **Prompt:** ``` List all files in the '/Client-Projects' folder. ``` **Response:** ``` I've retrieved the folder contents. Inside '/Client-Projects' you have: 'Contract_v1.pdf', 'Design_Mockup.png', and 'Project_Brief.docx'. Which one would you like more details on? ``` **Prompt:** ``` Show me the activity history for the last 24 hours. ``` **Response:** ``` Fetching audit logs... In the last 24 hours, there were 15 activities: 10 uploads, 3 downloads by Mike Ross, and 2 folder deletions. Would you like a detailed report on the deletions? ``` **Prompt:** ``` Create a new folder called '/Archive-2023'. ``` **Response:** ``` Success! The folder '/Archive-2023' has been created in your Files.com account. You can now start moving your legacy assets into this directory. ``` ## Capabilities ### Map folder structure List all files and directories within a specified path, allowing you to map the entire organizational storage hierarchy. ### Retrieve file metadata Get detailed information, including size, type, and last modified date, for any specific file. ### Monitor access control List all users, groups, and the detailed permissions assigned to them across the account. ### Review file activity Query historical and real-time logs to track every action taken on files, such as uploads, downloads, or deletions. ### Manage file structure Programmatically create new folders or delete unnecessary files and folders. ## Use Cases ### The compliance audit gap A compliance officer needs to prove that all client contract files were only accessed by the legal team. They ask their agent to run `list_activity_history` filtered by the client folder and 'Legal Team' users. The agent returns a filtered log showing only approved access attempts, satisfying the audit requirement. ### Restructuring a project directory The project lead finishes a phase and needs to archive all assets. They prompt their agent: 'Create a folder called /Archive-Q1' and then ask the agent to move all current files into it. The agent runs `create_folder` and then uses `delete_file` to clean up the old directory structure. ### Fixing permission creep The IT admin finds a sensitive folder with too many permissions. They use `list_permissions` to see exactly which groups have write access, then use `list_user_groups` to confirm the group name, and finally adjust the permissions via the agent. ### Onboarding a new team member The manager needs to grant access to a new hire. They first run `list_users` to check the employee's account ID, then `list_user_groups` to find the correct group, and finally use the agent to confirm the appropriate permissions are set for the new user. ## Benefits - Audit every file movement. Instead of manually running reports, use `list_activity_history` to pull a summary of all uploads, downloads, and deletions over a date range. - Maintain clean storage. Use `create_folder` or `delete_file` directly through your agent to build new project folders or purge outdated assets without leaving your workspace. - Verify who can see what. `list_permissions` instantly shows the access rights for any file or folder, letting you confirm compliance without clicking through user matrices. - Know your users and groups. `list_users` and `list_user_groups` let you pull a complete directory roster and group list to verify access scope before making changes. - Deep file insight. `get_file_details` provides the full metadata for a file—size, type, and path—allowing your agent to process specific data points. - See the whole structure. Use `list_folders` to map out the entire file system hierarchy at a given path, giving you a clear view of your current asset organization. ## How It Works The bottom line is, your AI client handles the connection and tool execution, letting you manage your secure files without touching the web interface. 1. Subscribe to the server and provide your Files.com API Key and Subdomain (e.g., yourcompany.files.com). 2. Your AI client authenticates with the server, establishing a secure connection to your file ecosystem. 3. You prompt the client with a natural language request (e.g., 'Show me the audit logs for last month') and the agent executes the necessary tool calls. ## Frequently Asked Questions **How do I use the Files.com MCP Server to list all users?** You run the `list_users` tool. This pulls a clean list of every account registered in your Files.com system. If you need to check the groups, use `list_user_groups` first. **Can I delete a file using the Files.com MCP Server?** Yes, you use the `delete_file` tool. Just provide the exact path to the file or folder you want gone. The agent handles the deletion command for you. **What if I need to know who has permissions on a folder?** Run `list_permissions` on the folder path. This tool lists all users and groups, and specifies exactly what level of access (read, write, etc.) they have. **Does list_activity_history track everything?** It tracks core file actions: uploads, downloads, and deletions. You can specify time ranges, and the tool returns a summary of those events for auditing purposes. **How do I list all available folders?** Use the `list_folders` tool and provide the starting directory path. This gives you a full overview of the current folder structure. **How do I use the `list_file_permissions` tool to check user groups?** The `list_permissions` tool shows detailed access rights for files and folders. You can use it to check specific users or list all organizational groups for a comprehensive security view. **What should I do if I get an error when running `get_file_details`?** If `get_file_details` fails, check the file path for typos or if the file actually exists. Error codes usually specify if the issue is permissions-related or if the resource is missing. **Does `list_users` handle deleted or inactive accounts?** The `list_users` tool lists all accounts configured in Files.com. It provides details on current users and groups, helping you manage your full directory roster. **Can I see who downloaded a specific file via AI?** Yes! Use the `list_activity_history` tool. Your agent will retrieve the audit logs, which you can filter to find download events for a particular file or user. **How do I create a new folder in my secure storage?** Use the `create_folder` action. Provide the path where you want the new directory to be created (e.g., '/projects/2024') and the agent will register it in Files.com instantly. **Is it possible to list all users in my Files.com instance via AI?** Absolutely. Use the `list_users` query. The agent will retrieve the complete directory of users configured for your company's instance.