Nextcloud MCP. Manage files, shares, and user status via chat.
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.
Give Claude and any AI agent real-world access
Create, list, or delete documents and directories within the Nextcloud storage.
Check current user details, retrieve full user profiles, or set custom online statuses for your team.
Generate new shares—for users, groups, or public links—and adjust their permissions and passwords.
Inspect the server's capabilities and manage app credentials directly from your agent.
Monitor recent changes across the cloud or fetch the current online status of other users.
Ask an AI about this
Waiting for input…
What AI agents can do with Nextcloud with 16 Tools
These tools let you perform every administrative function in Nextcloud—from creating folders to managing user credentials—all through simple, direct commands.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Nextcloud MCPGet 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...
Delete App Password
Removes an existing application password associated with your account for security...
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...
List Activities
Retrieves a feed of recent actions and changes that happened across the entire cloud...
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...
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on each call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Nextcloud, then connect any of our 5,200+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,200+ others, all in one place
- Add new capabilities to your AI anytime you want
- Connections are secured and governed automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog weekly
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Nextcloud. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS CLOUD
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on each call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
The friction point: Managing cloud permissions across multiple tools.
Today, managing a self-hosted cloud involves jumping between five different places. You log into the web UI to create a folder, switch to the sharing tab to set permissions, and then open the user profile page just to check if someone is online. If you need to delete something or change a share link, it's another manual click sequence that eats time.
With this MCP, your agent handles all of that complexity in one conversation. You don't navigate; you just tell the system what needs doing. It executes `create_folder`, manages permissions via `create_share`, and confirms the action—all without leaving your chat window.
Nextcloud MCP: Instant visibility into files, shares, and user status.
Gone are the days of having to manually run reports or click through multiple dashboards just to audit what happened. You can instantly call `list_activities` to see a full timeline of changes, or use `get_user_status` to check on team members.
Now, everything is unified under natural conversation. Your agent doesn't just describe the state; it performs the action for you. That’s the difference between reading a report and fixing the problem.
What Nextcloud MCP does for your AI
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.
019e38c7-e148-703b-af9a-f72b3bca3fe6 How to set up Nextcloud MCP
The bottom line is you treat complex cloud administration like chatting with a teammate who already has access to your system.
Subscribe to this MCP on Vinkius, providing your Nextcloud URL, username, and App Password.
Connect your agent from Claude, Cursor, or any compatible client. The connection authenticates your credentials against the self-hosted instance.
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.
Who uses Nextcloud MCP
This is for self-hosters, ops engineers, and project managers running internal Nextcloud instances. If you spend time switching between the chat window and the cloud admin dashboard, this MCP saves those clicks.
Manages user accounts, checks server capabilities via get_capabilities, and deletes outdated app passwords using delete_app_password.
Creates secure shares for specific teams or groups using create_share and manages document lifecycles by calling delete_file.
Keeps the team informed of availability by checking user status with get_user_status or setting a custom message with set_user_status_message.
Benefits of connecting Nextcloud MCP
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.
Nextcloud MCP 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.
Nextcloud MCP tradeoffs
What to watch out for, and the recommended way to handle each one.
Manual API scripting
Writing a Python script or using Postman to manually call separate endpoints for listing users, then creating shares, then setting status updates.
Connect this MCP via Vinkius. Your agent handles the sequence of calls internally when you ask it to 'Audit user access and set team status'—it’s all one prompt.
Over-sharing credentials
Having to copy-paste multiple API keys or passwords into various developer tools just to perform basic file operations.
You only authenticate once with your Nextcloud URL, username, and App Password. The MCP manages the secure connection for all subsequent actions.
Using generic cloud tooling
Relying on a general-purpose connector that can list files but doesn't understand specific user roles or share types (User, Group, Public Link).
This MCP understands Nextcloud specifics. You use create_share and specify the exact share type you need to ensure permissions are set correctly from day one.
When to use Nextcloud MCP
Use this MCP if your core workflow involves managing files, user access, or team presence within a self-hosted Nextcloud environment. You need to treat cloud administration like chatting with a colleague—simple, conversational, and immediate. Don't use it if you only need general file storage; that’s fine for any basic connector. But don't use it if your primary need is complex data transformation or database interaction; those require different connectors (like SQL MCPs). This tool excels at governance and actioning within the Nextcloud ecosystem, not on data outside of it.
Frequently asked questions about Nextcloud MCP
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.