# AIquila — Nextcloud MCP Server

> AIquila — Nextcloud MCP Server is an open-source MCP server for files and documents. Give MCP clients access to Nextcloud files, calendar, mail, Talk, Deck and more. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Linux, macOS, Windows
- **Repository:** https://github.com/elgorro/aiquila/tree/HEAD/mcp-server
- **MCP Registry name:** io.github.elgorro/aiquila-mcp
- **Categories:** files and documents, productivity
- **Listing updated:** 2026-11-15

## About

AIquila turns a Nextcloud instance into a toolbox for any MCP client. The README counts 384 tools across 47 categories, split into a 74-tool core (files, shares, comments, tags, users, groups, trash, versions and more), 32 tools tied to the AIquila Nextcloud app, and 278 tools that appear only when optional Nextcloud apps such as Maps, Forms, Polls, Deck, Talk, Mail or Calendar are installed. The registry entry quotes a smaller number, 349.

The server has no model of its own. Whatever client you connect brings its own, so there is no provider setting here; provider choice belongs to the separate AIquila Nextcloud app. It signs in with a Nextcloud username and an app password rather than your main password.

Stdio is the default, run through npx or a container image. Setting MCP_TRANSPORT to http and enabling OAuth lets remote clients such as Claude.ai connect. Details worth knowing: write_file is capped at 1 GB by default, and run_occ is limited to a read-only allowlist unless you widen it. It needs Node.js 26 or newer.

## Features

- **Large tool catalogue:** Spans 47 categories from files and shares to Maps and Cookbook.
- **App-aware tool sets:** Extra tools appear when optional Nextcloud apps are installed.
- **Stdio or HTTP:** Runs locally or as an HTTP server with optional OAuth.
- **App-password login:** Authenticates with a Nextcloud username and app password.
- **Guarded OCC access:** run_occ uses a read-only allowlist you can replace.

## Good for

- Let an assistant search and organise files in Nextcloud
- Create calendar events and tasks by chat
- Read and triage mail held in Nextcloud Mail
- Manage Deck cards and Talk conversations from an agent
- Run read-only occ commands for admin checks

## Install

### Claude Code (Terminal)

```sh
claude mcp add aiquila-mcp --env NEXTCLOUD_URL='<NEXTCLOUD_URL>' --env NEXTCLOUD_USER='<NEXTCLOUD_USER>' --env NEXTCLOUD_PASSWORD='<NEXTCLOUD_PASSWORD>' -- npx -y aiquila-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "aiquila-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "aiquila-mcp"
      ],
      "env": {
        "NEXTCLOUD_URL": "<NEXTCLOUD_URL>",
        "NEXTCLOUD_USER": "<NEXTCLOUD_USER>",
        "NEXTCLOUD_PASSWORD": "<NEXTCLOUD_PASSWORD>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "aiquila-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "aiquila-mcp"
      ],
      "env": {
        "NEXTCLOUD_URL": "<NEXTCLOUD_URL>",
        "NEXTCLOUD_USER": "<NEXTCLOUD_USER>",
        "NEXTCLOUD_PASSWORD": "<NEXTCLOUD_PASSWORD>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "aiquila-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "aiquila-mcp"
      ],
      "env": {
        "NEXTCLOUD_URL": "<NEXTCLOUD_URL>",
        "NEXTCLOUD_USER": "<NEXTCLOUD_USER>",
        "NEXTCLOUD_PASSWORD": "<NEXTCLOUD_PASSWORD>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "aiquila-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "aiquila-mcp"
      ],
      "env": {
        "NEXTCLOUD_URL": "<NEXTCLOUD_URL>",
        "NEXTCLOUD_USER": "<NEXTCLOUD_USER>",
        "NEXTCLOUD_PASSWORD": "<NEXTCLOUD_PASSWORD>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "aiquila-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "aiquila-mcp"
      ],
      "env": {
        "NEXTCLOUD_URL": "<NEXTCLOUD_URL>",
        "NEXTCLOUD_USER": "<NEXTCLOUD_USER>",
        "NEXTCLOUD_PASSWORD": "<NEXTCLOUD_PASSWORD>"
      }
    }
  }
}
```

## Tools

- `write_file`: Writes file content to Nextcloud, capped by MCP_MAX_FILE_SIZE
- `run_occ`: Runs Nextcloud occ commands restricted by an allowlist
- `get_local_time`: Returns local time using the configured BCP 47 locale

## FAQ

### Which model does it use?

None. It has no model of its own; your MCP client brings one.

### What do I need to run it?

Node.js 26 or newer and a Nextcloud instance with an app password.

### Can Claude.ai connect to it?

Yes, through the HTTP transport with OAuth enabled, as described in the Docker setup guide.

### Is it free?

Yes, it is MIT licensed free software.

### Is AIquila — Nextcloud MCP Server free?

Yes. AIquila — Nextcloud MCP Server is open source, so you can use and self-host it for free.

### How do I add AIquila — Nextcloud MCP Server to Claude Code?

Run this command in your terminal: claude mcp add aiquila-mcp --env NEXTCLOUD_URL='<NEXTCLOUD_URL>' --env NEXTCLOUD_USER='<NEXTCLOUD_USER>' --env NEXTCLOUD_PASSWORD='<NEXTCLOUD_PASSWORD>' -- npx -y aiquila-mcp

### What are the best alternatives to AIquila — Nextcloud MCP Server?

The closest alternatives to AIquila — Nextcloud MCP Server are Ha MCP, Concord MCP, note1, ASTra and CalderFlow.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/aiquila-nextcloud-mcp-server
