# hithereiamaliff-mcp-nextcloud

Connect an AI agent to Nextcloud to manage notes, calendar events, contacts, tables, and WebDAV files through MCP tools.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 38
- Author: hithereiamaliff
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hithereiamaliff/mcp-nextcloud
- Updated: 2026-03-14
- HTML: https://affpapa.org/en/nevibecode/mcp/hithereiamaliff-mcp-nextcloud

## What it does

The server gives an agent tools to create, find, edit, and remove notes, calendar events, contacts, and table rows. For WebDAV files, it can search names, contents, and metadata, browse directories, and read or write files. Search can be narrowed by file type, size, modification date, or directory, and matching text files can include previews.

Claude Code connects over HTTP to the MCP endpoint. Hosted clients can use a user-scoped `usr_...` key; the server resolves that key to Nextcloud credentials on its side rather than placing raw credentials in the URL. The key is tied to a user, so access setup depends on using the right one.

## Requirements
- Remote server: `https://server.smithery.ai/@hithereiamaliff/mcp-nextcloud/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http hithereiamaliff-mcp-nextcloud https://server.smithery.ai/@hithereiamaliff/mcp-nextcloud/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add hithereiamaliff-mcp-nextcloud --url https://server.smithery.ai/@hithereiamaliff/mcp-nextcloud/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hithereiamaliff-mcp-nextcloud": {
            "url": "https://server.smithery.ai/@hithereiamaliff/mcp-nextcloud/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hithereiamaliff-mcp-nextcloud": {
            "type": "http",
            "url": "https://server.smithery.ai/@hithereiamaliff/mcp-nextcloud/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http hithereiamaliff-mcp-nextcloud https://server.smithery.ai/@hithereiamaliff/mcp-nextcloud/mcp
```

## When to use it
- locate a Nextcloud file by its contents
- append new material to an existing note
- create or update a calendar event
- read and change rows in a Nextcloud table
- add a contact to an address book

## Example prompts
- Find Nextcloud PDF reports about the project from 2024.
- Add a calendar event with a description and location.
- Find the launch note and append a new item.

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44874
- [screenpipe](https://affpapa.org/en/nevibecode/mcp/screenpipe.md) — MCP server · ★ 22053
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12791
- [kaneo](https://affpapa.org/en/nevibecode/mcp/kaneo.md) — MCP server · ★ 9602
- [Mindwtr](https://affpapa.org/en/nevibecode/mcp/mindwtr.md) — MCP server · ★ 2318
- [Azure DevOps (ADO)](https://affpapa.org/en/nevibecode/mcp/azure-devops-ado.md) — MCP server · ★ 2067

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md