npm aiquila-mcpstreamable-httpMITupdated 8d ago
AIquila bridges your self-hosted Nextcloud instance with Claude AI. Instead of keeping your files, notes, tasks, and recipes locked inside Nextcloud — or copying them manually into a chat window — AIquila lets Claude read and write your Nextcloud data directly. You stay in control of your data on your own server; Claude gains the context it needs to actually help.
¿Qué puedes hacer con AIquila — Nextcloud MCP Server?
AIquila
Nextcloud + Claude AI Integration
What is AIquila?
AIquila bridges your self-hosted Nextcloud instance with Claude AI. Instead of keeping your files, notes, tasks, and recipes locked inside Nextcloud — or copying them manually into a chat window — AIquila lets Claude read and write your Nextcloud data directly. You stay in control of your data on your own server; Claude gains the context it needs to actually help.
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. Browse and manage files, read and create notes, handle tasks and bookmarks, manage projects, and query recipes — all stored in your Nextcloud.
Nextcloud App — A native Nextcloud application that surfaces Claude AI actions directly inside the Nextcloud UI. Summarize a document, analyze a spreadsheet, or generate content without leaving your Nextcloud.
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.
Getting Started
Pick the path that fits your setup:
| Path | What you get | Guide |
|---|---|---|
npx aiquila-mcp |
Claude Desktop/Code + Nextcloud | Quick start |
| Docker + OAuth | Claude.ai + Nextcloud | Quick start |
| Nextcloud App | AI inside Nextcloud UI | Quick start |
| Hetzner Cloud | Full production deploy | Quick start |
| Claude 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
License
AGPL-3.0 (Nextcloud App) / MIT (MCP Server)
See ACKNOWLEDGMENTS.md for the open-source projects and services AIquila is built on.
Instalación
Añade AIquila — Nextcloud MCP Server a tu cliente. Elige el que uses.
{
"servers": {
"aiquila-mcp": {
"type": "http",
"url": "https://{hostname}/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
claude mcp add aiquila-mcp -- npx -y aiquila-mcpcodex mcp add aiquila-mcp -- npx -y aiquila-mcpamp mcp add aiquila-mcp -- npx -y aiquila-mcp{
"mcpServers": {
"aiquila-mcp": {
"command": "npx",
"args": [
"-y",
"aiquila-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"aiquila-mcp": {
"command": "npx",
"args": [
"-y",
"aiquila-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"mcpServers": {
"aiquila-mcp": {
"command": "npx",
"args": [
"-y",
"aiquila-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"aiquila-mcp": {
"command": "npx",
"args": [
"-y",
"aiquila-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"aiquila-mcp": {
"command": "npx",
"args": [
"-y",
"aiquila-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"aiquila-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"aiquila-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"aiquila-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"aiquila-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y aiquila-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
Puntuación
39 / 100
Incompleta
- Documentación16/25
- Mantenimiento25/25
- Confianza13/20
- Capacidad0/15
- Instalación15/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 1 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 18 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Historial de versiones
| Versiones | Publicada |
|---|---|
| 0.4.4Última | 24 ago 2026 |
| 0.4.2 | 14 ago 2026 |
| 0.3.35 | 12 ago 2026 |
| 0.3.23 | 20 jun 2026 |
| 0.3.17 | 10 jun 2026 |
| 0.3.13 | 1 jun 2026 |
| 0.3.12 | 30 may 2026 |
| 0.3.7 | 27 may 2026 |
| 0.3.5 | 22 abr 2026 |
| 0.3.3 | 20 abr 2026 |
| 0.3.2 | 19 abr 2026 |
| 0.3.0 | 12 abr 2026 |
| 0.2.16 | 6 abr 2026 |
| 0.2.10 | 29 mar 2026 |
| 0.2.9 | 27 mar 2026 |
| 0.2.7 | 24 mar 2026 |
| 0.2.6 | 20 mar 2026 |
| 0.1.68 | 19 mar 2026 |
| 0.1.64 | 19 mar 2026 |
| 0.1.63 | 18 mar 2026 |
| 0.1.62 | 16 mar 2026 |
| 0.1.59 | 14 mar 2026 |
| 0.1.57 | 13 mar 2026 |
| 0.1.55 | 10 mar 2026 |
| 0.1.51 | 8 mar 2026 |
| 0.1.49 | 8 mar 2026 |
| 0.1.48 | 8 mar 2026 |
| 0.1.47 | 8 mar 2026 |
| 0.1.46 | 7 mar 2026 |
| 0.1.45 | 6 mar 2026 |
| 0.1.43 | 6 mar 2026 |
| 0.1.42 | 6 mar 2026 |
| 0.1.41 | 6 mar 2026 |
| 0.1.40 | 6 mar 2026 |
| 0.1.39 | 4 mar 2026 |
| 0.1.38 | 4 mar 2026 |
| 0.1.37 | 4 mar 2026 |
| 0.1.36 | 4 mar 2026 |
| 0.1.35 | 4 mar 2026 |
| 0.1.34 | 2 mar 2026 |
| 0.1.30 | 1 mar 2026 |