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.
What can you do with 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.
Install
Add AIquila — Nextcloud MCP Server to your client. Pick the one you use.
{
"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.
Score
39 / 100
Incomplete
- Documentation16/25
- Maintenance25/25
- Trust13/20
- Capability0/15
- Install experience15/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
Version history
| Versions | Published |
|---|---|
| 0.4.4Latest | Aug 24, 2026 |
| 0.4.2 | Aug 14, 2026 |
| 0.3.35 | Aug 12, 2026 |
| 0.3.23 | Jun 20, 2026 |
| 0.3.17 | Jun 10, 2026 |
| 0.3.13 | Jun 1, 2026 |
| 0.3.12 | May 30, 2026 |
| 0.3.7 | May 27, 2026 |
| 0.3.5 | Apr 22, 2026 |
| 0.3.3 | Apr 20, 2026 |
| 0.3.2 | Apr 19, 2026 |
| 0.3.0 | Apr 12, 2026 |
| 0.2.16 | Apr 6, 2026 |
| 0.2.10 | Mar 29, 2026 |
| 0.2.9 | Mar 27, 2026 |
| 0.2.7 | Mar 24, 2026 |
| 0.2.6 | Mar 20, 2026 |
| 0.1.68 | Mar 19, 2026 |
| 0.1.64 | Mar 19, 2026 |
| 0.1.63 | Mar 18, 2026 |
| 0.1.62 | Mar 16, 2026 |
| 0.1.59 | Mar 14, 2026 |
| 0.1.57 | Mar 13, 2026 |
| 0.1.55 | Mar 10, 2026 |
| 0.1.51 | Mar 8, 2026 |
| 0.1.49 | Mar 8, 2026 |
| 0.1.48 | Mar 8, 2026 |
| 0.1.47 | Mar 8, 2026 |
| 0.1.46 | Mar 7, 2026 |
| 0.1.45 | Mar 6, 2026 |
| 0.1.43 | Mar 6, 2026 |
| 0.1.42 | Mar 6, 2026 |
| 0.1.41 | Mar 6, 2026 |
| 0.1.40 | Mar 6, 2026 |
| 0.1.39 | Mar 4, 2026 |
| 0.1.38 | Mar 4, 2026 |
| 0.1.37 | Mar 4, 2026 |
| 0.1.36 | Mar 4, 2026 |
| 0.1.35 | Mar 4, 2026 |
| 0.1.34 | Mar 2, 2026 |
| 0.1.30 | Mar 1, 2026 |