MCP Server

Active

MIT

AIquila — Nextcloud MCP Server MCP Server

io.github.elgorro/aiquila-mcp

Private AI for your Nextcloud — access files, calendar, contacts, mail, tasks and 120+ tools securely.

What is the AIquila — Nextcloud MCP Server MCP server?

AIquila is a Nextcloud MCP server that gives AI assistants secure access to your Nextcloud data including files, calendar, contacts, mail, tasks, notes, and 120+ additional tools across 44 categories. Your data stays on your own server, and you choose which AI provider sees it—hosted API or local model.

AIquila bridges Nextcloud and AI by exposing your self-hosted Nextcloud data to MCP-compatible AI assistants without copying data manually. It includes an MCP server (342 tools), a native Nextcloud app for in-UI chat, and optional Hetzner Cloud deployment. Supports Claude, Mistral, local models, and other providers.

How to install AIquila — Nextcloud MCP Server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

NEXTCLOUD_URL
required
URL of your Nextcloud instance (e.g. https://cloud.example.com)
NEXTCLOUD_USER
required
Nextcloud username
NEXTCLOUD_PASSWORD
required
secret
Nextcloud app password (generate in Nextcloud Security settings)

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "aiquila-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "aiquila-mcp"
      ],
      "env": {
        "NEXTCLOUD_URL": "<YOUR_NEXTCLOUD_URL>",
        "NEXTCLOUD_USER": "<YOUR_NEXTCLOUD_USER>",
        "NEXTCLOUD_PASSWORD": "<YOUR_NEXTCLOUD_PASSWORD>"
      }
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

File Management — Browse, read, write, and manage files in Nextcloud
Calendar — Create, read, and manage calendar events
Contacts — Access and manage contact information
Mail — Read and compose emails
Tasks — Create and manage task lists
Notes — Create and manage notes
Photos — Organize and manage photo collections
Bookmarks — Manage bookmarks
Talk — Interact with Nextcloud Talk messaging
Deck — Manage Deck boards and cards
Coworkers — Run saved, repeatable AI jobs
Administration (occ) — Run Nextcloud administration commands

Use cases

Chat with an AI assistant about your Nextcloud documents and files while keeping data on your own server
Summarize and rewrite text within Nextcloud using your choice of AI provider
Automate recurring tasks with Coworkers (saved AI jobs) scoped to specific projects
Manage calendar events, tasks, and contacts through natural language with an AI assistant
Extract text from images and analyze documents with vision-capable AI providers

AIquila — Nextcloud MCP Server MCP server FAQ

What is AIquila?

AIquila is an MCP server that connects AI assistants to your self-hosted Nextcloud, exposing 342 tools across files, calendar, contacts, mail, tasks, notes, and more. Your data stays on your server; you choose the AI provider.

Is AIquila free?

Yes, AIquila is free software licensed under AGPL-3.0 (Nextcloud App) and MIT (MCP Server). The project accepts optional donations via GitHub Sponsors and Liberapay.

How do I install AIquila in Cursor or Claude?

Use the MCP server via npm (`npm: aiquila-mcp`), Docker OCI image (`ghcr.io/elgorro/aiquila-mcp:0.4.11`), or remote HTTP endpoint. Configure your MCP client to connect to the server with your Nextcloud credentials.

What AI providers does AIquila support?

Claude (Anthropic), Mistral, Hetzner Inference, DeepSeek, and local models (Ollama, LM Studio, llama.cpp). Each user can select a provider and model per conversation.

Do I need to host AIquila myself?

You can run the MCP server locally with `npx aiquila-mcp`, deploy it remotely with Docker, use the Nextcloud App, or provision a full production setup on Hetzner Cloud.

What authentication does AIquila require?

AIquila requires Nextcloud credentials to authenticate. The MCP server supports bearer/basic/header auth and mTLS for local models.

README (reference)

Source of truth, from the repository.

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

AI providers

The Nextcloud app supports five 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.
Hetzner Inference	Hetzner (German provider)	OpenAI-compatible. Currently an experimental Hetzner service, free while experimental; Hetzner states it does not store request and response content. Tokens from experiments.hetzner.com.
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.

Related MCP servers

io.github.eliaskress/flowcheck

Maintained

Stripe payouts, Shopify orders, and bank transactions unified for reconciliation and cash flow

TypeScript

MIT

View repository →

io.github.elibarnett/kie-mcp

Active

MCP for kie.ai: 45+ image, 70+ video, 20+ audio models with model intelligence

JavaScript

MIT

View repository →

io.github.eliottreich/taskbounty-check

Active

Local GitHub Actions/CI maintenance check (action pinning, token perms). Not a full security audit.

JavaScript

MIT

View repository →

io.github.eliottreich/taskbounty-mcp-server

Active

Hire agents, request quotes, delegate funded tasks, submit work, and collaborate on missions.

JavaScript

MIT

View repository →

Everything File Search

Active

Lightning-fast Windows file search for AI agents using Everything's real-time NTFS index

Python

MIT

View repository →

elisym

Active

AI agent discovery, marketplace, messaging, and payments on Nostr - no platform, no middleman

TypeScript

MIT

View repository →