How do I install Aiquila?

Aiquila supports both local and remote installation. For local use, install it via npm (npx) and add the configuration to your AI app. For remote access, add the server URL to your MCP configuration.

Is Aiquila safe to use?

Aiquila scored 6.4/10 (moderate risk) in MCP Marketplace's automated security scan. It has 1 high or critical finding to review. It's listed, but review the security report on this page before installing.

What credentials does Aiquila need?

Aiquila requires the following credentials or environment variables: NEXTCLOUD_URL, NEXTCLOUD_USER, NEXTCLOUD_PASSWORD. You can find setup instructions on the server detail page.

What AI apps work with Aiquila?

Aiquila uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Aiquila MCP Server

by Elgorro

Developer ToolsModerate6.4MCP RegistryLocalRemote

Free

Server data from the Official MCP Registry

Nextcloud MCP server — 349 tools: files, calendar, contacts, mail, Talk, Deck, photos, maps, notes

About

Nextcloud MCP server — 349 tools: files, calendar, contacts, mail, Talk, Deck, photos, maps, notes

Remote endpoints: streamable-http: https://{hostname}/mcp

Security Report

6.4

Moderate6.4Moderate Risk

AIquila is an MCP server and Nextcloud integration whose stated purpose requires network access and Nextcloud credentials, and the visible code shows credentials handled via env vars and 0600 .env files, with the .env written only to the user's own provisioned server. The visible portion shows no exfiltration or obfuscation, but the Hetzner provisioner runs many privileged remote commands (root shell over SSH, curl-piped install steps, and a token interpolated into a shell command) that users should review; the code was truncated so the full MCP tool implementations and auth logic could not be verified. Supply chain analysis found 1 known vulnerability in dependencies (0 critical, 1 high severity). Package verification found 1 issue.

8 files analyzed · 6 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

system_info

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

URL of your Nextcloud instance (e.g. https://cloud.example.com)Optional

Environment variable: NEXTCLOUD_URL

Nextcloud usernameOptional

Environment variable: NEXTCLOUD_USER

Nextcloud app password (generate in Nextcloud Security settings)Required

Environment variable: NEXTCLOUD_PASSWORD

How to Install & Connect

Available as Local & Remote

This plugin can run on your machine or connect to a hosted endpoint. during install.

Documentation

View on GitHub

From the project's GitHub README.

AIquila

Private AI for your Nextcloud — your data, your server, your choice of AI provider

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. 372 tools across 46 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 proxy, CrowdSec intrusion prevention, TLS, and optional monitoring.

AI providers

The Nextcloud app supports these providers for chat. Each user can pick a provider and model per conversation, within what the admin allows.

Provider	Hosting	Notes
Claude (Anthropic)	Anthropic API	The default, and the most deeply integrated: vision, thinking budgets, native MCP connector, and PDF handling with citations.
Claude on a cloud platform	Your AWS, Google Cloud or Azure account	The same Claude integration through Claude Platform on AWS, Claude on Google Cloud, Amazon Bedrock, Vertex AI or Microsoft Foundry, with the platform's billing, IAM and regions. Some platforms lack batches or the native MCP connector.
Hetzner Inference	Hetzner (German provider)	OpenAI-compatible. Currently an experimental Hetzner service, free while experimental. Hetzner is replacing it with an official product, and experiment tokens stop working on 8 December 2026. Hetzner states it does not store request and response content. No new tokens are issued.
Mistral	Mistral API (French provider)	Also supports the native MCP connector. Mistral offers EU-only processing through its regional inference endpoints.
Local model	Your own hardware	Ollama, LM Studio or llama.cpp. Nothing leaves your infrastructure. Supports bearer/basic/header auth and mTLS.
DeepSeek	DeepSeek API	OpenAI-compatible. No native MCP connector.

Provider choice applies to chat, the per-conversation model picker and the Nextcloud Assistant / TaskProcessing integrations, which all run on the provider the user has selected. Assistant actions that send images ("Analyze images", "Extract text from image") need a vision-capable provider, and report which of the available ones qualify when the selected provider is not.

Getting Started

Pick the path that fits your setup:

Path	What you get	Guide
`npx aiquila-mcp`	Local MCP client + Nextcloud	Quick start
Docker + OAuth	Remote MCP client + Nextcloud	Quick start
Nextcloud App	AI inside the Nextcloud UI	Quick start
Hetzner Cloud	Full production deploy	Quick start
Mobile + Voice	Phone + Nextcloud hands-free	Quick start

Getting Started Guide — all five paths with step-by-step instructions
Full Documentation — architecture, configuration, and advanced topics
Nextcloud compatibility — which Nextcloud versions are supported, and what "supported" means

Contributing

Contributions are welcome. Please read CONTRIBUTING.md first — most importantly, open or comment on an issue before writing code, so we can confirm the approach before you invest the effort.

The guide covers branch and commit conventions, the checks CI runs per component, and what to expect from CI on a pull request from a fork.

Support

AIquila is free software and developed in the open. If it is useful to you, funding covers the running costs behind it — test servers, CI minutes, domains and the App Store presence:

Contributing time — issues, pull requests, documentation, or simply telling other people about the project — helps just as much.

License

AGPL-3.0 (Nextcloud App) / MIT (MCP Server)

See ACKNOWLEDGMENTS.md for the open-source projects and services AIquila is built on.

Reviews

No reviews yet

Be the first to review this server!

4.8

Local

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.