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. 345 tools across 44 categories.

Quick Start

Stdio transport (local MCP clients)

Add to your MCP client configuration. Example for Claude Desktop (~/.config/claude/claude_desktop_config.json); Claude Code, Cursor and VS Code use the same server definition in their own config files:

{
	"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, remote MCP clients)

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

Which AI model does this use?

None. This server has no model of its own and no provider setting — it exposes your Nextcloud to whatever MCP client you point at it, and that client brings its own model. Provider choice (Claude, Hetzner Inference, Mistral, a local model, DeepSeek) belongs to the AIquila Nextcloud app, which is a separate component.

What It Can Do

Core (always available)

| Category | Tools | | ------------- | ----: | | Files | 15 | | Shares | 10 | | Apps | 6 | | Tags | 6 | | User Status | 5 | | Users | 4 | | Groups | 4 | | Notifications | 4 | | Status | 3 | | Absence | 3 | | Trash | 3 | | Search | 2 | | Versions | 2 | | Activity | 2 | | Subtotal | 69 |

AIquila app

| Category | Tools | | ------------ | ----: | | Projects | 7 | | Cowork | 15 | | AIquila | 3 | | Security | 2 | | OCC | 1 | | Subtotal | 25 |

Optional Nextcloud apps

| Category | Tools | | ---------------- | ----: | | Maps | 40 | | Social | 26 | | Forms | 25 | | Polls | 21 | | News | 17 | | Bookmarks | 13 | | Deck | 12 | | Photos | 11 | | Mail | 10 | | Talk | 10 | | Circles | 8 | | Calendar | 6 | | Tasks | 6 | | Contacts | 6 | | Cookbook | 6 | | Notes | 5 | | Text | 5 | | Terms of Service | 5 | | Assistant | 4 | | Announcements | 3 | | Passman | 3 | | Registration | 3 | | Translate | 1 | | Social Sharing | 1 | | Recommendations | 1 | | Subtotal | 248 |

Total: 345 tools.

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 | | MCP_AUTH_STATE_DIR | No | directory for persisted OAuth state (default /app/state) | | MCP_LAZY_AUTH | No | false requires a bearer token on every JSON-RPC method (default true) | | MCP_LOCALE | No | BCP 47 locale tag for get_local_time (e.g. sv-SE); defaults to the system locale | | MCP_MAX_FILE_SIZE | No | max write_file content length in bytes (default 1073741824 = 1 GB) | | MCP_ALLOWED_HOSTS | No | extra hostnames for DNS rebinding protection | | MCP_CORS_ORIGINS | No | extra browser origins allowed via CORS | | MCP_OCC_ALLOWLIST | No | allowlist entries for run_occ (cmd, cmd *); replaces the read-only default | | LOG_LEVEL | No | trace/debug/info/warn/error/fatal |

Requirements

• Node.js 26+
• 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 — the full tool catalogue
• Architecture — design and internals
• Full Documentation — complete docs index

Support

AIquila is free software. If it is useful to you, you can fund its development via GitHub Sponsors or Liberapay.

License

MIT — part of the AIquila project.