nextcloud

The Nextcloud MCP Server acts as an external bridge that lets AI assistants interact with your Nextcloud data via a secure API. It exposes a comprehensive set of MCP tools across Nextcloud apps (Notes, Calendar, Contacts, Files/WebDAV, Deck, Cookbook, Tables, Sharing, and Semantic Search). You can perform CRUD operations, manage calendars and contacts, access and modify files, and leverage optional semantic search to find information based on meaning rather than keywords. The server supports multiple transports (SSE, HTTP, and streamable-http) and can be deployed in Docker, Kubernetes, VM, or locally, making it suitable for production or development workloads. To use it, configure a Nextcloud connection (host, user, app password) and then connect your MCP client (Claude Desktop, IDE integrations, or mcp dev) to the server endpoint to start issuing natural language requests to Nextcloud data.

Prerequisites:

• Docker installed on your host (or a Kubernetes/VM setup depending on your environment)
• A Nextcloud instance with a user and an app password

Step-by-step:

1. Prepare environment variables for Nextcloud access (replace placeholders): NEXTCLOUD_HOST=https://your.nextcloud.instance.com NEXTCLOUD_USERNAME=your_username NEXTCLOUD_PASSWORD=your_app_password
2. Run the MCP server in Docker (example using the image from GitHub Packages): docker run -i --env NEXTCLOUD_HOST="$NEXTCLOUD_HOST"
   --env NEXTCLOUD_USERNAME="$NEXTCLOUD_USERNAME"
   --env NEXTCLOUD_PASSWORD="$NEXTCLOUD_PASSWORD"
   ghcr.io/cbcoutinho/nextcloud-mcp-server:latest
3. Verify the server is ready: curl http://127.0.0.1:8000/health/ready
4. Connect your MCP client to the server endpoint (e.g., http://127.0.0.1:8000/mcp or /sse) and start issuing natural language commands.

If you prefer Compose profiles for development/testing, use the provided docker-compose setups and port mappings from the documentation and adjust environment values accordingly.

Tips and common considerations:

• For full semantic search features, enable and provision the required vector store (e.g., Qdrant + Ollama) and opt-in via ENABLE_SEMANTIC_SEARCH.
• Basic Auth with app passwords is the recommended production authentication method; OAuth2/OIDC is experimental and requires Nextcloud patches.
• If you deploy behind a reverse proxy, ensure proper TLS termination and secure token handling for MCP clients.
• The server exposes multiple apps; use the MCP client to discover tools available for each app (Notes, Calendar, etc.).
• When using Docker, consider mounting a persistent volume for any necessary configuration or logs and setting appropriate resource limits for stability.