Nextcloud

Comprehensive Nextcloud MCP server with Notes, Tables, WebDAV, Calendar, Contacts, Cookbook, Deck, and Sharing support

python

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "no-smoke-nextcloud-mcp-comprehensive": {
      "command": "uv",
      "args": [
        "run",
        "nextcloud-mcp-server"
      ],
      "env": {
        "NEXTCLOUD_HOST": "https://your.nextcloud.instance.com",
        "NEXTCLOUD_PASSWORD": "your_app_password",
        "NEXTCLOUD_USERNAME": "your_username"
      }
    }
  }
}

You can run a standalone MCP server to let external AI clients securely access your Nextcloud data and perform actions like managing notes, calendars, contacts, files, and more. This server exposes a rich set of CRUD operations across multiple Nextcloud apps and supports OAuth2/OIDC or Basic Auth for per-user authentication, making it suitable for IDE integrations, AI assistants, and external tooling.

How to use

You will run the MCP server locally or in a container and connect an external MCP client (such as Claude Code, GPT-based tools, or other IDE integrations) to it. Start the server with Basic Auth or OAuth, then authorize the client to access the Nextcloud data you want to expose. Once running, you can issue natural language requests like creating notes, scheduling events, uploading files, or manipulating decks and recipes. The MCP server translates your requests into Nextcloud API calls via the available tools and resources.

How to install

Prerequisites you need before installation: a Nextcloud instance, Docker or a Kubernetes cluster (optional), and a tool to run the MCP server (UVX/uv or Docker). You should also decide whether you will use Basic Auth with an app password or OAuth (experimental) with OIDC patches.

# Install via local runtime (recommended for quick start)
uv sync

# Or pull and run via Docker (alternative)
docker pull ghcr.io/cbcoutinho/nextcloud-mcp-server:latest

# Optional: deploy to Kubernetes with Helm
helm repo add nextcloud-mcp https://cbcoutinho.github.io/nextcloud-mcp-server
helm repo update
helm install nextcloud-mcp nextcloud-mcp/nextcloud-mcp-server \
  --set nextcloud.host=https://cloud.example.com \
  --set auth.basic.username=myuser \
  --set auth.basic.password=mypassword

Additional sections

Configuration, security, and usage details are provided below to help you run, secure, and connect clients to the MCP server. Follow the examples to set up environment variables, start commands, and connection paths for your chosen authentication mode.

The server supports multiple transport protocols and offers a range of tools to interact with Nextcloud apps. You can see tools for Notes, Calendar, Contacts, Files (WebDAV), Deck, Cookbook, Tables, and Sharing, plus optional document processing, and cross-app actions.

If you want to connect your MCP client immediately, you can run a local MCP client session to test the connection, then request actions from natural language prompts.

Available tools

nc_notes_create_note

Create a new note in Notes app

nc_calendar_create_event

Create a calendar event in Calendar (CalDAV) with attendees and reminders

nc_contacts_create_contact

Create a contact in the Contacts app

nc_webdav_upload_file

Upload a file to WebDAV (Nextcloud Files) with optional OCR processing

deck_create_card

Create a Deck card in a specified board and stack

cookbook_import_recipe

Import a recipe into Cookbook from a URL with schema.org metadata

nc_calendar_create_todo

Create a CalDAV task/todo

nc_webdav_read_file

Read and extract content from documents or images via OCR processing

nc_sharing_create_share

Create and manage shares for files or folders

Built by

VeilStrat

AI signals for GTM teams