nextcloud-mcp

A remote MCP server that exposes a Nextcloud account as MCP tools: files (WebDAV), calendars (CalDAV), share links (OCS Share API), and Talk chat (proxy-read).

Need admin operations (create/disable users, quotas, groups) instead? See the sibling package, admin/ — it's a separate server with its own tiered authorization model, not part of this one.

Scope

User-level only: every tool call acts with the permissions of one Nextcloud account (an App Password, never the main account password), scoped exactly like that account logging into the Nextcloud web UI. There is no authorization model here beyond "whatever this account can already do" — for anything that needs per-caller permission tiers or targets other people's accounts, use nextcloud-admin-mcp.

Related MCP server: nextcloud-dynamic-mcp-server

Design

• Remote, not local. One deployment, always current with the MCP spec, no per-user install to keep updated.

• Stateless. No MCP protocol-level session — every request is self-contained, matching the 2026-07-28 MCP spec and Nextcloud's own stateless WebDAV/CalDAV/OCS APIs.

• Multi-tenant. One deployment serves any Nextcloud instance — the instance URL and credentials are per-request, not baked into the server.

• Auth via connection-layer headers, not tool arguments. The Nextcloud App Password never enters the LLM's context — the MCP client attaches it when it opens the connection, exactly like a local MCP server reading credentials from an env var.

For AI agents / MCP clients: connecting

Every request to POST /mcp must carry:

• Authorization: Basic <base64(username:app-password)> — standard HTTP Basic Auth. username/app-password are the Nextcloud account this request acts as (generate the App Password under the account's own Nextcloud Settings → Security → "Create new app password").

• X-Nextcloud-Url: https://your-nextcloud-instance.example — the base URL of the caller's Nextcloud instance.

No initialize handshake is required — tools/list and tools/call work directly per-request.

Example mcpServers entry (Claude Code / any HTTP-transport MCP client):

{
  "mcpServers": {
    "nextcloud-mcp": {
      "type": "http",
      "url": "https://your-deployment.example/mcp",
      "headers": {
        "Authorization": "Basic <base64(username:app-password)>",
        "X-Nextcloud-Url": "https://your-nextcloud-instance.example"
      }
    }
  }
}

Tools

Development

npm install
npm run build
npm test
PORT=3939 node dist/index.js

License

MIT