AIquila MCP Server

MCP (Model Context Protocol) server that gives any MCP client full access to your Nextcloud instance — files, calendar, tasks, contacts, mail, talk, maps, bookmarks, notes, polls, forms, and more. 244 tools across 33 categories.

Quick Start

Stdio (Claude Desktop, Claude Code, Cursor, etc.)

Add to your MCP client configuration (example for Claude Desktop ~/.config/claude/claude_desktop_config.json):

{
	"mcpServers": {
		"aiquila": {
			"command": "npx",
			"args": ["-y", "aiquila-mcp"],
			"env": {
				"NEXTCLOUD_URL": "https://your-nextcloud.example.com",
				"NEXTCLOUD_USER": "your-username",
				"NEXTCLOUD_PASSWORD": "your-app-password"
			}
		}
	}
}

Generate an App Password in Nextcloud: Settings → Security → Devices & sessions.

HTTP Transport (Docker, Claude.ai, remote clients)

See the Docker setup guide for running AIquila as an HTTP server with OAuth for remote MCP clients.

What It Can Do

Core (always available)

| Category | Tools | | ---------- | ----: | | Files | 12 | | Status | 3 | | Apps | 6 | | Tags | 6 | | Search | 2 | | Users | 4 | | Groups | 4 | | Shares | 10 | | Absence | 3 | | Trash | 3 | | Versions | 2 |

AIquila app

| Category | Tools | | ---------- | ----: | | AIquila | 3 | | Security | 2 | | OCC | 1 | | Projects | 7 |

Optional Nextcloud apps

| Category | Tools | | ------------- | ----: | | Calendar | 6 | | Tasks | 6 | | Contacts | 6 | | Notes | 5 | | Mail | 8 | | Deck | 12 | | Cookbook | 6 | | Maps | 25 | | Photos | 11 | | Talk | 10 | | Circles | 8 | | Bookmarks | 13 | | Polls | 21 | | Forms | 25 | | Assistant | 4 | | Translate | 1 | | User Status | 5 | | Notifications | 4 | | Total | 244 |

Configuration

| Variable | Required | Notes | | -------------------- | -------- | --------------------------------------------- | | NEXTCLOUD_URL | Yes | trailing slash stripped automatically | | NEXTCLOUD_USER | Yes | | | NEXTCLOUD_PASSWORD | Yes | use an App Password | | MCP_TRANSPORT | No | stdio (default) or http | | MCP_AUTH_ENABLED | No | true to enable OAuth for remote clients | | MCP_AUTH_SECRET | If auth | openssl rand -hex 32 | | MCP_AUTH_ISSUER | If auth | public HTTPS URL of this server | | LOG_LEVEL | No | trace/debug/info/warn/error/fatal |

Requirements

• Node.js 24+
• A Nextcloud instance with an App Password

Optional Nextcloud apps unlock additional tool categories: Tasks, Calendar, Contacts, Notes, Cookbook, Deck, Bookmarks, Mail, Maps, Photos, Talk, Circles, and more.

Documentation

• Setup Guide — detailed installation and configuration
• Tools Reference — all 198 tools documented
• Architecture — design and internals
• Full Documentation — complete docs index

License

MIT — part of the AIquila project.