Skip to content
MCP server

AIquila — Nextcloud MCP Server

Give MCP clients access to Nextcloud files, calendar, mail, Talk, Deck and more

Install
Pricing
Open source
Platforms
CLI, self-hosted, Linux
Runs
Locally or Remotely
Version
0.5.4
Listing updated
2 days ago

About AIquila — Nextcloud MCP Server

AIquila — Nextcloud MCP Server is an open-source MCP server for files and documents. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a 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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • NEXTCLOUD_URLURL of your Nextcloud instance (e.g. https://cloud.example.com)Required
  • NEXTCLOUD_USERNextcloud usernameRequired
  • NEXTCLOUD_PASSWORDNextcloud app password (generate in Nextcloud Security settings)Required
  • NEXTCLOUD_URLURL of your Nextcloud instance (e.g. https://cloud.example.com)Required
  • NEXTCLOUD_USERNextcloud usernameRequired
  • NEXTCLOUD_PASSWORDNextcloud app password (generate in Nextcloud Security settings)Required

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

MIT licence; donations via GitHub Sponsors and Liberapay

AIquila — Nextcloud MCP Server 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 to AIquila — Nextcloud MCP Server

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  6. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents