cbcoutinho/nextcloud-mcp-server
Nextcloud MCP Server
What it solves
This project provides a bridge between AI assistants (like Claude, GPT, and Gemini) and Nextcloud instances. It allows LLMs to interact with your personal data—such as notes, calendars, contacts, and files—using natural language, effectively turning your Nextcloud instance into a structured data source for an AI agent.
How it works
It is a standalone Model Context Protocol (MCP) server. It connects to a Nextcloud instance via a secure API using app-specific passwords or OAuth (Login Flow v2). Once connected, it exposes over 110 tools to an MCP-compatible client (like an IDE or Claude Desktop), enabling the AI to perform CRUD operations across various Nextcloud apps.
Who it’s for
Users and developers who self-host Nextcloud and want to integrate their personal productivity data into their AI workflows without needing to integrate the AI directly into the Nextcloud UI.
Highlights
- Broad App Support: Covers 10+ Nextcloud apps including Notes, Calendar, Contacts, Files, Deck, and Mail.
- Semantic Search: An experimental RAG pipeline using Qdrant and Ollama to find content by meaning rather than just keywords.
- Document Processing: Built-in OCR and text extraction for PDFs, DOCX, and images.
- Flexible Deployment: Supports Docker, Kubernetes, VM, or local installation via
uvx. - Secure Authentication: Supports Basic Auth with app passwords and a multi-user Login Flow v2 for hosted deployments.