AiquilaBLOCK
Private AI for your Nextcloud — an MCP server (316 tools), a native Nextcloud app with chat and Coworkers, and one-command Hetzner deployment.
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
Private AI for your Nextcloud — your data, your server, your choice of AI provider
[](https://github.com/elgorro/aiquila/actions/workflows/nc-release.yml) [](https://github.com/elgorro/aiquila/actions/workflows/mcp-release.yml)
What is AIquila?
AIquila brings AI to your self-hosted Nextcloud. Instead of keeping your files, notes, tasks and recipes locked inside Nextcloud — or copying them by hand into a chat window — AIquila lets an AI assistant read and write your Nextcloud data directly. Your data stays on your own server, and you decide which AI provider sees it: a hosted API, or a model running on your own hardware that sends nothing to anyone.
How it works
AIquila has three components that can be used independently or together:
MCP Server — A Model Context Protocol server that gives any MCP-compatible AI assistant secure access to your Nextcloud. 342 tools across 44 categories: browse and manage files, keep calendars, tasks and contacts in sync, work in Talk, Deck and Mail, organise photos, notes and bookmarks, and run Coworkers and occ administration. It has no model of its own — it exposes Nextcloud to whichever MCP client you connect.
Nextcloud App — A native Nextcloud application that brings AI directly into the Nextcloud UI. Chat about your documents, summarise and rewrite text, run Coworkers (saved, repeatable AI jobs), and scope a conversation to a Project so the assistant only sees the folders you choose. Admins pick which providers are available, and may restrict them per user or group.
Hetzner Deployment — A single-command provisioning tool (aiquila-hetzner) that stands up a production-ready AIquila server on Hetzner Cloud, complete with Traefik reverse
1be7fbf524efOBSERVED · 2026-10-08Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add aiquila-mcp --env NEXTCLOUD_PASSWORD=${NEXTCLOUD_PASSWORD} --env NEXTCLOUD_PASSWORD=${NEXTCLOUD_PASSWORD} -- npx -y [email protected]claude mcp add aiquila-mcp:0.4.16 --env NEXTCLOUD_PASSWORD=${NEXTCLOUD_PASSWORD} --env NEXTCLOUD_PASSWORD=${NEXTCLOUD_PASSWORD} -- docker run -i --rm ghcr.io/elgorro/aiquila-mcp:0.4.16:NoneExposed tools (2)
2 read · 0 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
Headline | read | Generate a headline |
Summarize | read | Summarize text |
Trust audit
BLOCKgrade F · trust 53/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | FAIL |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (12 observation(s))
- Network
- declared (9 observation(s))
- Shell
- declared (2 observation(s))
- Dependencies
- not all pinned
- Secrets in source
- found
Findings (25)
exec('which ' . escapeshellarg($candidate) . ' 2>/dev/null', $out);cmd.Flags().StringVar(&deploySSHKey, "ssh-key", "", "SSH private key path (default: ~/.ssh/aiquila_ed25519)")
cmd.Flags().StringVar(&logsSSHKey, "ssh-key", "", "SSH private key path (default: ~/.ssh/aiquila_ed25519)")
keyDesc := "generate Ed25519 → " + home + "/.ssh/aiquila_ed25519"
/.env" ... curl
/.env" ... curl
/.env" ... curl
NODE_TLS_REJECT_UNAUTHORIZED=0 MCP_URL=https://localhost:3340 tsx test-mcp-connector.ts
NODE_TLS_REJECT_UNAUTHORIZED=0 MCP_URL=https://localhost:3340 tsx test-mistral-mcp.ts
const input = `mysql://admin:super_secret@localhost/nextcloud`;
secret: 'instance_secret_value',
password: 'ENCRYPTED_CIPHERTEXT_PW',
password: 'ENCRYPTED_CIPHERTEXT_PW',
dav-utils.test.ts
.php-cs-fixer.php
# ~/.ssh/aiquila_ed25519 and the public half is uploaded automatically.
# ssh_key: ~/.ssh/id_ed25519.pub
context: ../../mcp-server
- ../../mcp-server:/app
cd ../../mcp-server/scripts && npm install --silent && \
cd ../../mcp-server/scripts && npm install --silent && \
import { NextcloudOAuthProvider } from '../../auth/provider.js';'test_base_url' => 'http://169.254.169.254/latest/meta-data',
'test_base_url' => 'http://169.254.169.254/latest/meta-data',
body: '<table><tr><td>Left</td><td>Right</td></tr></table><img alt="Big Headline" src="x.png">',
Gates applied: no_behavioural_pass.
1be7fbf524effull audit observations/trust-audit/mcp-server/elgorro__aiquila.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-08 | 1be7fbf524ef | BLOCK | F | 53 | first audit |
Questions
What is the Aiquila MCP server?
Private AI for your Nextcloud — an MCP server (316 tools), a native Nextcloud app with chat and Coworkers, and one-command Hetzner deployment.
What tools does Aiquila expose?
2 in total: 2 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is Aiquila safe to connect to an agent?
No — not without reading the findings first. The audit graded it F (53/100) and found 9 critical or high issues in the source. Each one is listed on this page with the file and line it is on.
What credentials does Aiquila need?
It reads ANTHROPIC_API_KEY, MCP_ALLOW_UNAUTHENTICATED, MCP_AUTH_ENABLED, MCP_AUTH_ISSUER, MCP_AUTH_SECRET, MCP_AUTH_STATE_DIR, MCP_CLIENT_SECRET, MCP_INTERNAL_TOKEN, MCP_LAZY_AUTH, MCP_REGISTRATION_TOKEN, MISTRAL_API_KEY and NEXTCLOUD_PASSWORD from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does Aiquila run?
It speaks stdio and streamable-http, so it runs as a local process your client starts. It is published on npm as aiquila at 0.4.16.
How current is this page?
The grade is for one exact copy of the source (1be7fbf524ef), read on 2026-10-08. The repository is watched and re-audited when it changes.