# AIquila — Nextcloud MCP Server

An MCP server that hands your AI client the keys to Nextcloud: files, calendar, mail, notes, maps and dozens of other apps.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 39
- Author: elgorro
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/elgorro/aiquila/tree/HEAD/mcp-server
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/aiquila-nextcloud-mcp-server

## What it does

Point the server at your Nextcloud instance with a URL, a username and an app password, and it exposes 342 tools across 44 categories. The core set — files, shares, apps, tags, users, groups, notifications, trash, search, versions, activity — is always there. Everything else appears depending on which apps your instance runs: Maps, Social, Forms, Polls, News, Bookmarks, Deck, Photos, Mail, Talk, Circles, Calendar, Tasks, Contacts, Cookbook, Notes, Text and more.

There is no model inside. AIquila does not generate anything and has no provider setting; it just serves Nextcloud to whichever MCP client connects, and that client supplies its own model. Picking a provider is the job of the separate AIquila Nextcloud app.

You need Node.js 26+ and an app password from Nextcloud (Settings → Security → Devices & sessions). Three variables are required: `NEXTCLOUD_URL`, `NEXTCLOUD_USER`, `NEXTCLOUD_PASSWORD`. Transport defaults to `stdio`, with `http` available for remote clients. Exposing the server publicly without `MCP_AUTH_ENABLED=true` and a secret from `openssl rand -hex 32` leaves it reachable with no authorization.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://{hostname}/mcp`
- Environment variables: `NEXTCLOUD_URL`, `NEXTCLOUD_USER`, `NEXTCLOUD_PASSWORD` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add --env NEXTCLOUD_URL=<NEXTCLOUD_URL> --env NEXTCLOUD_USER=<NEXTCLOUD_USER> --env NEXTCLOUD_PASSWORD=<NEXTCLOUD_PASSWORD> --transport stdio mcp-server -- npx -y aiquila-mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http aiquila-mcp https://{hostname}/mcp
```

### Codex

1. **Platform CLI**
```bash
codex mcp add mcp-server --env NEXTCLOUD_URL=<NEXTCLOUD_URL> --env NEXTCLOUD_USER=<NEXTCLOUD_USER> --env NEXTCLOUD_PASSWORD=<NEXTCLOUD_PASSWORD> -- npx -y aiquila-mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
codex mcp add mcp-server --url https://{hostname}/mcp
```

### Cursor

1. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "aiquila-mcp"
            ],
            "env": {
                "NEXTCLOUD_URL": "<NEXTCLOUD_URL>",
                "NEXTCLOUD_USER": "<NEXTCLOUD_USER>",
                "NEXTCLOUD_PASSWORD": "<NEXTCLOUD_PASSWORD>"
            }
        }
    }
}
```
Replace <…> with your own values

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "url": "https://{hostname}/mcp"
        }
    }
}
```

### GitHub Copilot

1. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "aiquila-mcp"
            ],
            "env": {
                "NEXTCLOUD_URL": "<NEXTCLOUD_URL>",
                "NEXTCLOUD_USER": "<NEXTCLOUD_USER>",
                "NEXTCLOUD_PASSWORD": "<NEXTCLOUD_PASSWORD>"
            }
        }
    }
}
```
Replace <…> with your own values

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "http",
            "url": "https://{hostname}/mcp"
        }
    }
}
```

### Gemini CLI

1. **Platform CLI**
```bash
gemini mcp add -e NEXTCLOUD_URL=<NEXTCLOUD_URL> -e NEXTCLOUD_USER=<NEXTCLOUD_USER> -e NEXTCLOUD_PASSWORD=<NEXTCLOUD_PASSWORD> mcp-server npx -y aiquila-mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http mcp-server https://{hostname}/mcp
```

## When to use it
- browse and manage Nextcloud files from a chat window
- add a task in Tasks without opening the web UI
- look up a contact or an email through the MCP client
- publish a note or a poll from the editor
- check calendar availability before scheduling

## Example prompts
- List the files in the root of my Nextcloud
- Create a task in Tasks for tomorrow with a reminder
- Find a contact by last name in my address book

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
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