← Back to directory

Nextcloud MCP Server

Community

A production-ready MCP server that connects AI assistants to your Nextcloud instance.

GitHub source repository ↗

★ 338 Stars Category · Cloud Storage Very popular Source revision 6c6f6f0d1b8a

67FMRS · C

Reliability

10/20

Security and permissions

12/20

Maintenance

16/20

Documentation

16/20

Setup experience

13/20

The Nextcloud MCP Server is a feature-rich MCP server providing broad API coverage for Nextcloud with multiple authentication and deployment options. It is suitable for users who want deep integration between AI assistants and Nextcloud, but requires careful credential handling and awareness that it is not an official project.

Read the FMRS scoring method →

The Nextcloud MCP Server is a standalone MCP server that enables LLMs like Claude, GPT, and Gemini to interact with your Nextcloud data through a secure API. It provides over 110 MCP tools covering more than 10 Nextcloud apps, including Notes, Calendar, Contacts, Files (WebDAV), Deck, Cookbook, Tables, Sharing, News, Mail, Collectives, and Talk. The server supports multiple authentication modes (single-user BasicAuth, multi-user BasicAuth pass-through, and Login Flow v2) and flexible deployment options (Docker, Kubernetes, VM, or local). It also offers experimental semantic search (RAG-based) for vector search across Notes, Files, News items, Deck cards, and Mail messages.

Tools

notes.*

Full CRUD, keyword search, and semantic search for Notes.

calendar.*

Manage events, todos, recurring events, attendees, and availability.

contacts.*

Full CardDAV support, address books.

files.*

Filesystem access, OCR, and document processing from PDFs, DOCX, images.

deck.*

Manage boards, stacks, cards, labels, assignments.

cookbook.*

Recipe management, URL import (schema.org).

tables.*

Row operations on Nextcloud Tables.

sharing.*

Create and manage shares.

news.*

Manage feeds, folders, items, feed health monitoring.

mail.*

Accounts, mailboxes, messages, attachments, send; flags, tags, move, delete.

collectives.*

Full CRUD on collectives, pages, and tags.

talk.*

List conversations, read/post messages, mark as read, list participants.

semantic_search.*

Vector search for Notes, Files, News items, Deck cards, and Mail messages (experimental).

Setup

Install via uvx or Docker. 2. Set environment variables NEXTCLOUD_HOST, NEXTCLOUD_USERNAME, and NEXTCLOUD_PASSWORD (use an app password). 3. Run with uvx nextcloud-mcp-server run --transport stdio or the Docker image. 4. Add the command or HTTP endpoint to your MCP client configuration.

claude_desktop_config.json

{
  "mcpServers": {
    "nextcloud": {
      "command": "uvx",
      "args": [
        "nextcloud-mcp-server",
        "run",
        "--transport",
        "stdio"
      ],
      "env": {
        "NEXTCLOUD_HOST": "https://your.nextcloud.instance.com",
        "NEXTCLOUD_USERNAME": "your_username",
        "NEXTCLOUD_PASSWORD": "your_app_password"
      }
    }
  }
}

Generate and validate client config

Fit and risk

Best for

Users who want to integrate AI assistants (like Claude Desktop or IDEs) with a self-hosted Nextcloud instance.
Developers and power users who need deep CRUD operations across multiple Nextcloud apps.
Teams that prefer Docker or Kubernetes deployment.

Not for

Users who don't want to self-host (consider managed service Astrolabe Cloud).
Users who need only simple read-only access (this server is more comprehensive).
Users who require official support (it is not an official Nextcloud project).

Required permissions

Requires a Nextcloud username and app password (or OAuth).
Read/write access to the selected Nextcloud apps (Notes, Calendar, Contacts, Files, etc.).
For semantic search, needs external services: Qdrant and Ollama (disabled by default).

Risks and side effects

Credential storage with app passwords may pose a security risk if exposed.
The server can access a user's full Nextcloud data, so proper access controls are necessary.
Experimental semantic search relies on external services, which may introduce security and privacy issues.
Tag-based exclusion (EXCLUDED_TAGS) depends on system tags to hide sensitive files, misconfiguration could expose data.

Troubleshooting

Check that environment variables are correctly set.
Ensure your Nextcloud instance is reachable.
Verify app password is correctly generated.
For semantic search, ensure Qdrant and Ollama are running and reachable.
Refer to the documentation's troubleshooting guide (docs/troubleshooting.md).

Use cases

Create and manage notes, calendar events, and contacts via natural language.

Search and process files, including OCR and document extraction.

Manage Deck boards, Cookbook recipes, and Tables.

Collaborate with your team via Talk and share files.

Perform semantic search across your Nextcloud content (experimental).

Supported clients

Claude DesktopFull support

Related MCP servers

Compare with other MCP servers