Nextcloud
Nextcloud MCP Server
What is Nextcloud?
Nextcloud is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to nextcloud mcp server
Nextcloud MCP Server
This server falls under the File Systems category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Nextcloud MCP Server
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx nextcloudConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Nextcloud
The Nextcloud MCP Server gives AI assistants access to over 110 tools across 10 Nextcloud apps — including Notes, Calendar, Contacts, Files, Deck (kanban boards), Talk, and Collectives — letting them read, create, update, and search content across your entire Nextcloud instance through natural language. It supports multiple authentication modes including single-user app passwords and multi-user OAuth via Nextcloud Login Flow v2, and optionally enables semantic vector search using Qdrant and Ollama. Individuals and teams use it to let AI assistants manage their self-hosted productivity suite: drafting and saving notes, scheduling events, moving Deck cards, and searching documents.
Prerequisites
- A running Nextcloud instance (self-hosted or a hosted provider)
- A Nextcloud app password generated in Settings > Security > Devices & sessions (recommended over your login password)
- Python 3.10+ and the uv tool installed
- An MCP-compatible AI client such as Claude Desktop or Cursor
- Optional: Qdrant and Ollama for semantic search (ENABLE_SEMANTIC_SEARCH=true)
Generate a Nextcloud app password
Log in to your Nextcloud instance, go to Settings > Security > Devices & sessions, and create a new app password. Copy this password — it will be used as NEXTCLOUD_PASSWORD in the configuration.
Test the connection with uvx
Before adding to an MCP client, verify your credentials work by running the server directly from the command line with uvx.
NEXTCLOUD_HOST=https://your.nextcloud.instance.com \
NEXTCLOUD_USERNAME=your_username \
NEXTCLOUD_PASSWORD=your_app_password \
uvx nextcloud-mcp-server run --transport stdioConfigure the server in your MCP client
Add the Nextcloud MCP server to your MCP client configuration file with your instance URL, username, and app password.
Optional: enable semantic search
To enable vector-based semantic search across your files and notes, start Qdrant and Ollama and set the ENABLE_SEMANTIC_SEARCH environment variable to true.
# Set in your MCP client config env section:
ENABLE_SEMANTIC_SEARCH=trueRestart your MCP client and verify
Restart Claude Desktop or your client. Ask it to list your Nextcloud notes to confirm the server is connected and authenticated.
Nextcloud Examples
Client configuration
Register the Nextcloud MCP server in Claude Desktop using uvx and your Nextcloud credentials.
{
"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
Once connected, use these prompts to interact with your Nextcloud data.
- "List all my Nextcloud notes and summarize their topics."
- "Create a new note called 'Project Ideas' with the following content: [your content]."
- "Show me all calendar events for next week."
- "Move the Deck card 'Fix login bug' to the Done stack on the Engineering board."
- "Find all files in my Nextcloud that contain the word 'invoice' and list their names and paths."Troubleshooting Nextcloud
Authentication fails with 401 or 'Invalid credentials'
Make sure you are using an app password, not your Nextcloud login password. Go to Settings > Security > Devices & sessions and generate a new app password. Regular passwords may be blocked by two-factor authentication.
Specific Nextcloud apps show no tools or return empty results
The corresponding Nextcloud app must be installed and enabled on your Nextcloud instance. For example, the Deck tools require the Deck app, and Talk tools require the Talk app. Enable them in Nextcloud's App management settings.
Semantic search returns no results even when ENABLE_SEMANTIC_SEARCH=true
Semantic search requires both Qdrant and Ollama running and accessible. Check that QDRANT_URL and OLLAMA_URL are set correctly in your environment and that embeddings have been generated (the server must first index your content before search works).
Frequently Asked Questions about Nextcloud
What is Nextcloud?
Nextcloud is a Model Context Protocol (MCP) server that nextcloud mcp server 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.