# Nextcloud MCP for AI Agents AI Agent Connect > Nextcloud MCP. Connect your self-hosted cloud to your AI agent. Manage files, create shares, update statuses, and check instance capabilities directly from your chat without switching tabs. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_Jkq8tANCmVo8yxKCd86qZgIi0uT7TVYlyKHTE2P4/ai-agent-connect - **Tags:** file-sharing, cloud-hosting, self-hosted, user-management, status-tracking ## Description This Nextcloud MCP lets you manage your self-hosted cloud storage through natural conversation. Instead of clicking through a web UI to organize your data, you can just tell your agent what to do. If you need to share a project folder with a client, you don't have to navigate menus to set permissions. Your agent handles the link creation and access rules for you in one step. It works by connecting directly to your instance, letting you pull activity logs or check what apps are running on your cloud during a conversation. This is a big win for anyone tired of the tab-hopping between their cloud storage and their workspace. When you use this Connector through the Vinkius catalog, you're giving your AI agent a set of hands to manage your private files, group permissions, and team statuses in real-time. It turns your self-hosted infrastructure into a conversational interface where you can just ask to create a folder or find a specific share. You get a direct line to your data without the friction of a traditional dashboard. ## Tools ### create_folder Create a new folder in your storage. This uses WebDAV to keep your files organized. ### get_capabilities This tool shows what your Nextcloud instance can do. It displays your version and active apps. ### create_share Create a new share for users, groups, or public links. It handles different types like emails or federated links. ### delete_app_password Remove an old app password. This is useful for security when you no longer need a specific connection. ### delete_file Remove a file or folder from your storage. It uses WebDAV to perform the deletion. ### delete_share Delete a specific share link. Use this to revoke access to shared content. ### get_app_password Generate a new app password. This requires your real password but keeps your account secure. ### get_user_status Check your current status. See if you are currently online or offline. ### get_user Fetch detailed info for a specific user. This is helpful for checking account details. ### list_activities View the activity stream. See what has been happening in your Nextcloud environment recently. ### list_files See what is inside a directory. It lists files relative to your user root. ### list_shares See all your active shares. This helps you keep track of what you have shared with others. ### list_users List all users on the instance. This requires admin privileges to view the full list. ### set_user_status Change your online status. This lets people see if you are away or active. ### set_user_status_message Update your custom status message. You can even add symbols to let your team know what you are up to. ### update_share Modify an existing share. Use this to change permissions or links for shared content. ## Prompt Examples **Prompt:** ``` Can you show me what apps are currently running on my Nextcloud? ``` **Response:** ``` I've checked your server capabilities. Here is what is currently active: - **Files** - **Photos** - **Talk** - **Calendar** Your instance is running version 27.1.0 and supports uploads up to 10GB. ``` **Prompt:** ``` I need to share the 'Marketing_Assets' folder with the design team. ``` **Response:** ``` I've created a new share for the 'Marketing_Assets' folder. **Share Details:** - **Type:** Group - **Permissions:** Read/Write - **Status:** Active You can now provide the link to the design team. ``` **Prompt:** ``` Set my status to 'In a meeting' so people know I'm busy. ``` **Response:** ``` Done. I've updated your status to 'In a meeting'. ``` ## Capabilities ### Create folders in storage Make new directories in your Nextcloud instance using natural language. ### Generate share links Create public or private links for users, groups, or email addresses. ### Update online status Set your presence and custom status messages for your team to see. ### List directory contents See all files and folders within a specific path in your cloud. ### Check instance capabilities View your current version, enabled apps, and server limits. ### Monitor activity streams Retrieve a list of recent changes and actions within your environment. ### Manage app passwords Create and delete secure passwords for connecting your agent to the cloud. ## Use Cases ### Sharing a project folder with a client A designer needs to share a large folder. They ask their agent to create a public share for '/Projects/Client-A' with read-only access. ### Checking team availability A manager wants to see who is active. They ask the agent to list all users and check their current status messages. ### Verifying server health A developer needs to check server stats. They ask the agent to show the server capabilities and list enabled apps. ### Updating status during a break A user is on a lunch break. They tell the agent to set their status to 'away' with a pizza emoji. ## Benefits - Stop clicking through menus to create folders because create_folder lets your agent do it in one step. - Share files instantly with create_share to manage public links and group permissions without leaving your chat. - Keep your team updated by using set_user_status_message to change your availability and custom messages. - Audit your storage easily with list_files and list_shares to see exactly what is hosted and shared. - Secure your instance by managing credentials with get_app_password and delete_app_password. - Monitor your environment by pulling the recent activity stream using list_activities. ## How It Works The bottom line is you get a voice-controlled interface for your private cloud storage. 1. Subscribe to the Connector and enter your Nextcloud URL, username, and app password. 2. Connect your preferred AI client like Claude or Cursor to the instance. 3. Ask your agent to manage files, create shares, or check your cloud status. ## Frequently Asked Questions **What can I do with the Nextcloud MCP?** You can manage your files, folders, and shares using just your voice or text. It lets you create folders, generate share links, and check your cloud status without opening a browser. **Is this for personal cloud storage?** Yes, it is designed for anyone running a self-hosted Nextcloud instance who wants a faster way to manage their data. **Can I use this to share files with clients?** Absolutely. You can ask your agent to create public or private links for specific folders or files instantly. **How do I keep my account secure?** The Connector works with app passwords. You can use get_app_password to create a unique key for your AI agent so you do not have to share your main login. **Can I see what is happening on my server?** Yes, you can pull the activity stream to see recent changes or check the server's capabilities and enabled apps. **Does this work with my existing Nextcloud setup?** It works with any standard Nextcloud instance. You just need to provide your URL and the necessary credentials. **How do I create a public share link for a specific folder?** Use the `create_share` tool. Provide the `path` to your folder and set `shareType` to 3 (Public Link). You can also optionally set a `password` for added security. **Can I change my online status message using the AI?** Yes! You can use `set_user_status` to change your availability (e.g., 'dnd', 'away') and `set_user_status_message` to set a custom text and emoji icon. **Is it possible to see which apps are enabled on my Nextcloud server?** Absolutely. Use the `get_capabilities` tool to retrieve a full list of server features, version information, and all currently enabled applications.