Nextcloud
Connects AI assistants to Nextcloud instances with 90+ tools for managing notes, calendars, contacts, files, recipes, and more through natural language conversations. Supports semantic search and multiple deployment options.
What is Nextcloud?
Nextcloud is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to connects ai assistants to nextcloud instances with 90+ tools for managing notes, calendars, contacts, files, recipes, and more through natural language conversations. supports semantic search and mult...
Connects AI assistants to Nextcloud instances with 90+ tools for managing notes, calendars, contacts, files, recipes, and more through natural language conversations. Supports semantic search and multiple deployment options.
This server falls under the File Systems category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Connects AI assistants to Nextcloud instances with 90+ tools
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx nextcloud-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Nextcloud
The Nextcloud MCP server connects AI assistants to a self-hosted or cloud Nextcloud instance, exposing 110+ tools across Notes, Calendar, Contacts, Files, Deck, Cookbook, Tables, Sharing, News, Collectives, and Talk. It supports natural language file management, OCR-based document processing, semantic vector search (via Qdrant and Ollama), and multiple transport options including stdio and streamable HTTP. Individuals and teams use it to manage their personal cloud data through conversation — creating calendar events, searching documents, managing kanban boards, and importing recipes — all without leaving their AI assistant.
Prerequisites
- A running Nextcloud instance (version 26+ recommended) accessible over HTTPS
- Python 3.11+ and uv package manager installed (`pip install uv` or `brew install uv`)
- A Nextcloud app password (generate at Settings > Security > App passwords — safer than your login password)
- Claude Desktop, Claude Code, or another MCP-compatible client
- (Optional) Qdrant and Ollama running locally if you want semantic search (ENABLE_SEMANTIC_SEARCH=true)
Generate a Nextcloud app password
In your Nextcloud instance, go to User Settings > Security > App passwords, create a new app password named 'MCP', and copy it. This is safer than using your login password.
Add the MCP server to your client configuration
Add nextcloud-mcp-server to your Claude Desktop config, providing your Nextcloud host URL, username, and the app password you just created.
{
"mcpServers": {
"nextcloud": {
"command": "uvx",
"args": ["nextcloud-mcp-server", "run", "--transport", "stdio"],
"env": {
"NEXTCLOUD_HOST": "https://your.nextcloud.instance.com",
"NEXTCLOUD_USERNAME": "your_username",
"NEXTCLOUD_PASSWORD": "your_app_password"
}
}
}
}Restart your MCP client
Restart Claude Desktop (or reload MCP servers in Claude Code) so it picks up the new configuration and connects to your Nextcloud instance.
Verify the connection
Ask a simple question to confirm the server is connected and returning data from your Nextcloud instance.
(Optional) Enable semantic search
To enable vector-based semantic search across your notes and files, start Qdrant and Ollama locally, then add the ENABLE_SEMANTIC_SEARCH environment variable.
{
"mcpServers": {
"nextcloud": {
"command": "uvx",
"args": ["nextcloud-mcp-server", "run", "--transport", "stdio"],
"env": {
"NEXTCLOUD_HOST": "https://your.nextcloud.instance.com",
"NEXTCLOUD_USERNAME": "your_username",
"NEXTCLOUD_PASSWORD": "your_app_password",
"ENABLE_SEMANTIC_SEARCH": "true"
}
}
}
}Nextcloud Examples
Client configuration
Claude Desktop configuration for the Nextcloud MCP server using uvx (no local install required). Replace the host, username, and password with your actual Nextcloud details.
{
"mcpServers": {
"nextcloud": {
"command": "uvx",
"args": ["nextcloud-mcp-server", "run", "--transport", "stdio"],
"env": {
"NEXTCLOUD_HOST": "https://your.nextcloud.instance.com",
"NEXTCLOUD_USERNAME": "your_username",
"NEXTCLOUD_PASSWORD": "your_app_password"
}
}
}
}Prompts to try
Use these prompts to manage your Nextcloud data through natural language with the 110+ available tools.
- "Create a note titled 'Meeting Notes' with today's agenda items"
- "List all calendar events for next week and summarize them"
- "Find all PDF files in my Documents folder and list their titles"
- "Add a new card to my 'In Progress' stack on the Development board in Deck"
- "Import this recipe URL into my Cookbook: https://example.com/pasta-recipe"
- "Search my notes for anything related to the Q3 planning session"Troubleshooting Nextcloud
Authentication fails with 401 Unauthorized
Ensure you are using an app password, not your login password. App passwords are generated at Settings > Security > App passwords. Login passwords may be blocked if two-factor authentication is enabled.
uvx command not found
Install uv with `pip install uv` or on macOS with `brew install uv`. After installation verify with `uvx --version`. If uvx is not on your PATH, add `~/.local/bin` (Linux) or the uv install directory to your PATH.
NEXTCLOUD_HOST connection refused or SSL certificate error
Make sure NEXTCLOUD_HOST is the full HTTPS URL including the protocol (e.g. https://cloud.example.com). For self-signed certificates, you may need to configure SSL verification settings or add the certificate to your system trust store.
Frequently Asked Questions about Nextcloud
What is Nextcloud?
Nextcloud is a Model Context Protocol (MCP) server that connects ai assistants to nextcloud instances with 90+ tools for managing notes, calendars, contacts, files, recipes, and more through natural language conversations. supports semantic search and multiple deployment options. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Nextcloud?
Follow the installation instructions on the Nextcloud GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Nextcloud?
Nextcloud works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Nextcloud free to use?
Yes, Nextcloud is open source and available under the AGPL-3.0 license. You can use it freely in both personal and commercial projects.
Nextcloud Alternatives — Similar File Systems Servers
Looking for alternatives to Nextcloud? Here are other popular file systems servers you can use with Claude, Cursor, and VS Code.
Electerm
★ 14.1k📻Terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(linux, mac, win)
Plik
★ 1.8kPlik is a temporary file upload system (Wetransfer like) in Go.
Kordoc
★ 957An MCP server that parses South Korean document formats like HWP, HWPX, and PDF into Markdown. It features specialized table reconstruction and security-hardened extraction optimized for administrative and public institution files.
macOS Automator
★ 801A Model Context Protocol server that enables execution of AppleScript and JavaScript for Automation scripts on macOS, allowing programmatic control of applications and system functions through a rich knowledge base of pre-defined scripts.
PDF Reader
★ 723Enables reading, searching, and metadata extraction from PDF files without loading the entire content into the context window. It provides efficient tools for text cleaning, page-specific extraction, and context-aware search results.
Filesystem MCP Server
★ 643Provides comprehensive filesystem operations (read, write, list, create, delete, move files and directories) through the Model Context Protocol with Streamable HTTP transport and built-in security through configurable root directory restrictions.
Browse More File Systems MCP Servers
Explore all file systems servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Nextcloud in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Nextcloud?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.