AIquila — Nextcloud MCP Server
Give MCP clients access to Nextcloud files, calendar, mail, Talk, Deck and more
- 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-mcpAdd 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)RequiredNEXTCLOUD_USERNextcloud usernameRequiredNEXTCLOUD_PASSWORDNextcloud app password (generate in Nextcloud Security settings)RequiredNEXTCLOUD_URLURL of your Nextcloud instance (e.g. https://cloud.example.com)RequiredNEXTCLOUD_USERNextcloud usernameRequiredNEXTCLOUD_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

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

CARTESIAN ECU
MCP serverCheck and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)
Not checked yet- 5 tools
- Remote
- Paid
- Files and documents