nextcloud-mcp-server

What it does

Nextcloud MCP Server exposes 110+ tools across Nextcloud's ecosystem—Notes, Calendar, Contacts, Files, Deck, Cookbook, Tables, Sharing, News, Collectives, and Talk. Claude and other LLMs can create and edit notes, manage calendar events and todos, organize contacts and files, administer Kanban boards, and moderate chat conversations through natural language. The server runs independently of Nextcloud (on Docker, Kubernetes, or bare metal) and handles CRUD operations, document processing including OCR and text extraction from PDFs and images, and optional semantic search over Notes and Files.

Who it's for

Nextcloud administrators and teams wanting their AI assistant to read and write data across their instance—product managers organizing notes, engineers querying documentation files, support staff logging tickets as Kanban cards, or anyone delegating calendar and contact management to Claude.

Common use cases

• Query and create notes from Claude, with semantic search for retrieving relevant context
• Manage calendar events and todo items across multiple calendars
• Search and organize files via WebDAV, with OCR on PDFs and images
• Create and move Kanban cards on Deck boards and manage assignments
• Moderate and read messages in Nextcloud Talk conversations

Setup pitfalls

• Four secrets are embedded in the server configuration: NEXTCLOUD_HOST, NEXTCLOUD_USERNAME, NEXTCLOUD_PASSWORD, and OAuth credentials for multi-user deployments. Use an app password instead of your login credential, and protect these values in your MCP client configuration.
• The server reads and writes files on your Nextcloud instance. Use tag-based exclusion (EXCLUDED_TAGS) to hide sensitive files before exposing the server to untrusted clients.
• Semantic search requires optional external infrastructure (Qdrant and Ollama); without it, only keyword search is available for Notes and Files.
• Docker deployment is required for full feature support; local installation via uvx has reduced capability.