M
MCP Directory CURATED DIRECTORY
911 MCP servers indexed
中文
← Back to directory
N

Nextcloud MCP Server

Community
A production-ready MCP server that connects AI assistants to your Nextcloud instance.
How to install ↓ Compare GitHub source repository ↗
Category
Cloud Storage #2 of 15
Stars
★ 381 Very popular
Transport
stdio (local process) · Streamable HTTP
Runtime
Docker · Python
Credentials
API key / credential required
License
AGPL-3.0
Last commit
Tools
13
67FMRS · C

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.

Strongest · Documentation 16/20 Weakest · Reliability 10/20

Reliability
10/20
Security and permissions
12/20
Maintenance
16/20
Documentation
16/20
Setup experience
13/20
Why each score
Reliability 10/20
The repository has a complete structure with many tool definitions and tests, but lacks verifiable CI workflows and key-path test evidence, limiting the reliability score.
Security and permissions 12/20
Uses app passwords and OAuth login flows, provides tag-based exclusion for sensitive files, but lacks explicit confirmation for dangerous operations and credential handling details are opaque.
Maintenance 16/20
Project is active with frequent commits and releases, provides a security response channel, and has a clear AGPL-3.0 license, but governance or versioning strategy details are absent.
Documentation 16/20
Documentation is layered and covers installation, configuration, authentication, and troubleshooting, but may lack some limitations and cost disclosures.
Setup experience 13/20
Offers multiple deployment options (uvx, Docker, Kubernetes) with clear client configuration examples, but dependency on external services may add setup complexity.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessReads local filesWrites / deletes local filesUses the networkConnects to a database

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.

Setup

Before you start

Runtime：Docker · Python

NEXTCLOUD_HOST required Full URL of your Nextcloud instance, e.g. https://your.nextcloud.instance.com.
NEXTCLOUD_USERNAME required Your Nextcloud username.
NEXTCLOUD_PASSWORD requiredsecret A Nextcloud app password generated under Settings > Security > Devices & sessions; do not use your login password.
Other optional settings (2)
EXCLUDED_TAGS optional Optional; a Nextcloud system tag name used to hide tagged sensitive files/folders from MCP file tools.
ENABLE_SEMANTIC_SEARCH optional Optional; enables the experimental semantic search pipeline (default false), requires Qdrant and Ollama.
  1. 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"
      }
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json
{
  "servers": {
    "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"
      }
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add nextcloud -e NEXTCLOUD_HOST=https://your.nextcloud.instance.com -e NEXTCLOUD_USERNAME=your_username -e NEXTCLOUD_PASSWORD=your_app_password -- uvx nextcloud-mcp-server run --transport stdio

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

Add the server to your MCP client config (uvx nextcloud-mcp-server run --transport stdio) and restart; tools like notes.* and calendar.* should appear in the tool list. Ask the AI to list your Nextcloud notes — a real answer proves the connection works.

Troubleshooting

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

Things to try

Once connected, you can ask your AI assistant things like:

  • Create a new note in my Nextcloud Notes titled 'Meeting notes'.
  • List all my calendar events for next week on Nextcloud.
  • Search my Nextcloud files for documents containing 'invoice'.
  • Send an email to Jane with the subject 'Project update' via my Nextcloud Mail.

Tools 13

notes.* writes
Full CRUD, keyword search, and semantic search for Notes.
calendar.* writes
Manage events, todos, recurring events, attendees, and availability.
contacts.* writes
Full CardDAV support, address books.
files.* writes
Filesystem access, OCR, and document processing from PDFs, DOCX, images.
deck.* writes
Manage boards, stacks, cards, labels, assignments.
cookbook.* writes
Recipe management, URL import (schema.org).
tables.* writes
Row operations on Nextcloud Tables.
sharing.* writes
Create and manage shares.
Show 5 more tools
news.* writes
Manage feeds, folders, items, feed health monitoring.
mail.* destructive
Accounts, mailboxes, messages, attachments, send; flags, tags, move, delete.
collectives.* writes
Full CRUD on collectives, pages, and tags.
talk.* writes
List conversations, read/post messages, mark as read, list participants.
semantic_search.* read-only
Vector search for Notes, Files, News items, Deck cards, and Mail messages (experimental).

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 Desktop

Listed from the project's documentation, not tested by this site.

Overview

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.

Similar servers

Compare with other MCP servers

Source revision b73c5622efe2 Data synced 2026-10-12 Read the FMRS scoring method