Skip to content
appsgit

Nextcloud MCP Server

Nextcloud MCP Server is an MCP server that connects AI assistants to your Nextcloud instance. It has 376 GitHub stars, is released under the AGPL-3.0 license and runs locally with uvx nextcloud-mcp-server. It works with Claude Desktop, Claude Code, Cursor and VS Code and needs an API key.

github.com/cbcoutinho/nextcloud-mcp-server (opens in a new tab)

Install Nextcloud MCP Server

Generated from the server's published package. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "nextcloud-mcp-server": {
      "command": "uvx",
      "args": [
        "nextcloud-mcp-server"
      ],
      "env": {
        "NEXTCLOUD_PASSWORD": "your-value"
      }
    }
  }
}

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

Claude Code

claude mcp add --env NEXTCLOUD_PASSWORD=your-value --transport stdio nextcloud-mcp-server -- uvx nextcloud-mcp-server

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "nextcloud-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "nextcloud-mcp-server"
      ],
      "env": {
        "NEXTCLOUD_PASSWORD": "your-value"
      }
    }
  }
}

Project file; use ~/.cursor/mcp.json to enable it in every project.

VS Code

.vscode/mcp.json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "nextcloud_password",
      "description": "NEXTCLOUD_PASSWORD",
      "password": true
    }
  ],
  "servers": {
    "nextcloud-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "nextcloud-mcp-server"
      ],
      "env": {
        "NEXTCLOUD_PASSWORD": "${input:nextcloud_password}"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
NEXTCLOUD_HOSTNoShown in the README's example configuration.
NEXTCLOUD_USERNAMENoShown in the README's example configuration.
NEXTCLOUD_PASSWORDsecretNoShown in the README's example configuration.

About Nextcloud MCP Server

A production-ready MCP server that connects AI assistants to your Nextcloud instance. Enable Large Language Models like Claude, GPT, and Gemini to interact with your Nextcloud data through a secure API. Create notes, manage calendars, organize contacts, work with files, and more - all through natural language conversations.

  • mcp-server
  • nextcloud
  • nextcloud-notes
  • model-context-protocol
  • nextcloud-deck
  • rag

FAQ

Nextcloud MCP Server FAQ

Still curious? Email info@appsgit.com.

What is Nextcloud MCP Server?

Nextcloud MCP Server is an MCP server that connects AI assistants to your Nextcloud instance. It has 376 GitHub stars, is released under the AGPL-3.0 license and runs locally with uvx nextcloud-mcp-server. It works with Claude Desktop, Claude Code, Cursor and VS Code and needs an API key. The source code is at github.com/cbcoutinho/nextcloud-mcp-server.

How do I install the Nextcloud MCP Server MCP server?

Add the command uvx nextcloud-mcp-server to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Nextcloud MCP Server free?

The server is open source under the AGPL-3.0 license, so running it is free. It needs credentials (NEXTCLOUD_PASSWORD) for the service it connects to, which may require a paid account.

Is Nextcloud MCP Server actively maintained?

The most recent commit was on Oct 6, 2026. The latest release is v0.198.5, published Oct 6, 2026. appsgit only lists MCP servers with a commit in the last six months and re-checks every server daily.