# Nextcloud MCP > Nextcloud MCP connects your self-hosted cloud instance to any AI agent. Use this connector to manage files, folders, and shares; list user profiles, or change team status updates directly from natural conversation. It gives your agent full administrative control over your productivity suite. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** file-sharing, cloud-hosting, self-hosted, user-management, status-tracking ## Description If your company runs a self-hosted Nextcloud environment, this MCP lets your AI client take direct control of it. You manage the whole system—files, permissions, user presence—without opening another tab or dashboard. Need to delete an old folder? Just ask. Want to set your team’s online status and message it automatically? Done. It's about turning complex administrative actions into simple commands within your chat environment. Because we host all these specialized connections at Vinkius, you connect once from your preferred AI client and get access to this full suite of cloud tools right away. ## Tools ### get_capabilities Retrieves detailed information about the Nextcloud server's supported features and apps. ### create_folder Builds a new directory within your Nextcloud storage structure. ### create_share Establishes a new share, specifying whether it belongs to a user, group, or is open to the public. ### delete_app_password Removes an existing application password associated with your account for security reasons. ### delete_file Permanently removes a specified file or folder from the Nextcloud storage. ### delete_share Removes an existing share, ensuring that access is revoked across all linked users. ### get_app_password Generates a brand new app password for use in external applications after authenticating with your main account credentials. ### get_user_status Checks the current online status of the user linked to this MCP. ### get_user Fetches detailed profile information for a specific Nextcloud user by their ID or username. ### list_activities Retrieves a feed of recent actions and changes that happened across the entire cloud environment. ### list_files Shows all files located within a specified directory path in Nextcloud. ### list_shares Lists every share currently configured across the entire instance for auditing purposes. ### list_users Provides a comprehensive list of all user accounts registered in the Nextcloud system (requires admin rights). ### set_user_status_message Updates your personal online status message with custom text and emojis. ### set_user_status Changes the overall visible online status of the connected user (e.g., online, away). ### update_share Modifies the permissions or settings of an existing share to reflect new access requirements. ## Prompt Examples **Prompt:** ``` Show me the capabilities and enabled apps of my Nextcloud server. ``` **Response:** ``` I've retrieved your server capabilities. You are running Nextcloud 27.1.0. Enabled apps include Files, Photos, Talk, and Calendar. Your server supports large file uploads up to 10GB. ``` **Prompt:** ``` Create a public share link for the folder '/Documents/Project-Alpha' with read-only permissions. ``` **Response:** ``` I've created the public share for '/Documents/Project-Alpha'. The share ID is 45. You can access it via the generated public link. Permissions are set to Read (1). ``` **Prompt:** ``` Set my status to 'away' and my message to 'Out for lunch' with a pizza emoji. ``` **Response:** ``` Your status has been updated to 'away' and your custom message is now 'Out for lunch 🍕'. ``` ## Capabilities ### Manage files and folders Create, list, or delete documents and directories within the Nextcloud storage. ### Control user status and profiles Check current user details, retrieve full user profiles, or set custom online statuses for your team. ### Govern data sharing Generate new shares—for users, groups, or public links—and adjust their permissions and passwords. ### Administer system settings Inspect the server's capabilities and manage app credentials directly from your agent. ### Track activity and presence Monitor recent changes across the cloud or fetch the current online status of other users. ## Use Cases ### Onboarding a new client folder A project manager needs a dedicated, read-only space for external consultants. Instead of manually creating the directory and sharing it in three steps, they ask their agent to first `create_folder` within /Client-X/ and then use `create_share`, specifying public link access with read permissions. ### Checking team availability before a call A team lead needs to know if two specific members are available for an emergency meeting. They prompt their agent to run `get_user_status` on both accounts, getting instant confirmation of who is online or currently set to 'away'. ### Cleaning up old documentation An engineer realizes a massive folder from last quarter needs removal. Instead of manually navigating and deleting hundreds of files, they ask their agent to `delete_file` for the entire archive path, confirming deletion instantly. ### Auditing user access rights The system administrator needs to audit who has access to sensitive data. They run `list_shares` and then use `get_user` on specific accounts to verify roles and permissions across the entire instance. ## Benefits - Automate file operations. Instead of using the web interface to create a folder or delete old documents, just ask your agent to `create_folder` or `delete_file`. It happens instantly. - Control team visibility. Quickly check who's online with `get_user_status`, and set custom messages for everyone else by calling `set_user_status_message`. Keep the team in sync without opening a dedicated chat tool. - Streamline sharing governance. Generating secure shares is simple: use `create_share` to quickly grant access to specific groups or users, setting precise permissions right from your conversation. - Perform admin tasks easily. Don't waste time navigating role menus. You can inspect server capabilities with `get_capabilities` and manage user lists using `list_users`, all through a simple command. - Centralize auditing. Get an immediate overview of what happened across the team by calling `list_activities`. This centralizes monitoring that used to require digging into multiple logs. ## How It Works The bottom line is you treat complex cloud administration like chatting with a teammate who already has access to your system. 1. Subscribe to this MCP on Vinkius, providing your Nextcloud URL, username, and App Password. 2. Connect your agent from Claude, Cursor, or any compatible client. The connection authenticates your credentials against the self-hosted instance. 3. Use natural language prompts to issue commands, such as 'create a public share for Project Gamma' or 'list all users'. The MCP executes the action and reports the result. ## Frequently Asked Questions **How do I list all users with Nextcloud MCP?** You use the `list_users` tool. Be aware that this action requires administrator privileges on the connected Nextcloud instance to run successfully. **Can Nextcloud MCP set my online status message?** Yes, you can update your personal status and custom message using `set_user_status_message`. This is useful for telling colleagues when you'll be back after lunch. **What is the difference between list_files and list_activities in Nextcloud MCP?** The tools serve different purposes. `list_files` shows the physical contents of a specific folder path, while `list_activities` provides an audit log of actions taken across the entire system. **Do I need developer skills to use Nextcloud MCP?** No. You interact with this MCP using plain English conversation through your agent. The tool handles all the underlying code and API calls for you. **How do I generate a new app password with Nextcloud MCP?** You call `get_app_password`. This process requires that you first authenticate using your main user credentials to ensure security before generating the key.