Nextcloud MCP Server
@cbcoutinho
About Nextcloud MCP Server
Nextcloud MCP Server
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"nextcloud-mcp-server": {
"command": "uvx",
"args": [
"nextcloud-mcp-server",
"run",
"--transport",
"stdio"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is Nextcloud MCP Server?
A production-ready MCP server that connects AI assistants to your Nextcloud instance, enabling Large Language Models like Claude, GPT, and Gemini to interact with Nextcloud data through a secure API. It provides deep CRUD operations across Nextcloud apps including Notes, Calendar, Contacts, Files, Deck, Cookbook, Tables, Sharing, News, Mail, Collectives, and Talk.
How to use Nextcloud MCP Server?
Run with uvx nextcloud-mcp-server run --transport stdio and set NEXTCLOUD_HOST, NEXTCLOUD_USERNAME, and NEXTCLOUD_PASSWORD environment variables (use a Nextcloud app password). Alternatively run with Docker and connect MCP clients to http://127.0.0.1:8000/mcp. Add the server to your MCP client configuration (e.g. claude_desktop_config.json) using the uvx command and environment variables.
Key features of Nextcloud MCP Server
- 110+ MCP tools across 10 Nextcloud apps
- MCP Resources for structured data URIs
- Optional vector-powered semantic search (experimental)
- OCR and text extraction from PDFs, DOCX, and images
- Flexible deployment: Docker, Kubernetes, VM, or local
- Multi‑user authentication via Login Flow v2 (OAuth)
- Tag‑based file exclusion to hide sensitive content
Use cases of Nextcloud MCP Server
- Create, read, update, and delete notes via natural language
- Manage calendar events, todos, and recurring appointments
- Organize contacts and address books
- Work with files, including OCR and document processing
- Control Deck boards, stacks, cards, and assignments
FAQ from Nextcloud MCP Server
Which Nextcloud apps are supported?
Notes, Calendar, Contacts, Files (WebDAV), Deck, Cookbook, Tables, Sharing, News, Mail, Collectives, and Talk (spreed) — with a total of 110+ tools.
What authentication methods are available?
Single‑user (Basic Auth with app password), multi‑user Basic Auth pass‑through, and multi‑user Login Flow v2 (OAuth‑based). Login Flow v2 is recommended for hosted deployments and works with stock Nextcloud.
How can I exclude sensitive files from MCP tools?
Use tag‑based file exclusion: tag files or folders with a configured Nextcloud system tag (set via EXCLUDED_TAGS in environment variables). Those items are hidden from MCP file operations.
Is semantic search available out of the box?
Semantic search is experimental and disabled by default. It requires a vector database (Qdrant) and an embedding service (Ollama). Opt in by setting ENABLE_SEMANTIC_SEARCH=true and providing the required infrastructure.
Can I use this server without self-hosting infrastructure?
Astrolabe Cloud (under development) offers a managed hosting service with advanced features like background sync and semantic search. Sign up on the landing page to join the early‑adopter list.
Frequently asked questions
Which Nextcloud apps are supported?
Notes, Calendar, Contacts, Files (WebDAV), Deck, Cookbook, Tables, Sharing, News, Mail, Collectives, and Talk (spreed) — with a total of 110+ tools.
What authentication methods are available?
Single‑user (Basic Auth with app password), multi‑user Basic Auth pass‑through, and multi‑user Login Flow v2 (OAuth‑based). Login Flow v2 is recommended for hosted deployments and works with stock Nextcloud.
How can I exclude sensitive files from MCP tools?
Use tag‑based file exclusion: tag files or folders with a configured Nextcloud system tag (set via `EXCLUDED_TAGS` in environment variables). Those items are hidden from MCP file operations.
Is semantic search available out of the box?
Semantic search is experimental and disabled by default. It requires a vector database (Qdrant) and an embedding service (Ollama). Opt in by setting `ENABLE_SEMANTIC_SEARCH=true` and providing the required infrastructure.
Can I use this server without self-hosting infrastructure?
Astrolabe Cloud (under development) offers a managed hosting service with advanced features like background sync and semantic search. Sign up on the landing page to join the early‑adopter list.
Basic information
More Other MCP servers
Reactive Resume
amruthpillaiA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
Inbox Zero AI MCP
elie222The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Production-ready MCP integrations for AI applications
Klavis-AIKlavis AI: MCP integration platforms that let AI agents use tools reliably at any scale
DeepMark
DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.
MCP Go 🚀
mark3labsA Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.
Comments