https://github.com/elgorro/aiquila
Connect Claude AI to your Nextcloud via the Model Context Protocol. Browse, search, and manage files through natural conversation.
https://github.com/elgorro/aiquila
ai anthropic claude docker hetzner mcp model-context-protocol nextcloud nextcloud-app php productivity self-hosted typescript
Last synced: 2 months ago
JSON representation
Connect Claude AI to your Nextcloud via the Model Context Protocol. Browse, search, and manage files through natural conversation.
- Host: GitHub
- URL: https://github.com/elgorro/aiquila
- Owner: elgorro
- License: mit
- Created: 2025-11-21T11:20:12.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-03-27T08:18:17.000Z (3 months ago)
- Last Synced: 2026-03-27T08:36:14.128Z (3 months ago)
- Topics: ai, anthropic, claude, docker, hetzner, mcp, model-context-protocol, nextcloud, nextcloud-app, php, productivity, self-hosted, typescript
- Language: TypeScript
- Homepage:
- Size: 2.34 MB
- Stars: 11
- Watchers: 0
- Forks: 1
- Open Issues: 52
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# AIquila
Nextcloud + Claude AI Integration
[](https://github.com/elgorro/aiquila/actions/workflows/nc-release.yml)
[](https://github.com/elgorro/aiquila/actions/workflows/mcp-release.yml)
## 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](https://modelcontextprotocol.io) 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](docs/installation.md#path-1-claude-desktop--claude-code-simplest) |
| Docker + OAuth | Claude.ai + Nextcloud | [Quick start](docs/installation.md#path-2-claudeai-remote-mcp) |
| Nextcloud App | AI inside Nextcloud UI | [Quick start](docs/installation.md#path-3-nextcloud-app) |
| Hetzner Cloud | Full production deploy | [Quick start](docs/installation.md#path-4-self-hosted-on-hetzner-cloud) |
| Claude Mobile + Voice | Phone + Nextcloud hands-free | [Quick start](docs/installation.md#path-5-claude-mobile-app-voice) |
- [Getting Started Guide](docs/installation.md) — all five paths with step-by-step instructions
- [Full Documentation](docs/README.md) — architecture, configuration, and advanced topics
## License
AGPL-3.0 (Nextcloud App) / MIT (MCP Server)
See [ACKNOWLEDGMENTS.md](ACKNOWLEDGMENTS.md) for the open-source projects and services AIquila is built on.