Nextcloud MCP Server

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.