Aiquila
Connect Claude AI to your Nextcloud via the Model Context Protocol. Browse, search, and manage files through natural conversation.
What is Aiquila?
Aiquila is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to connect claude ai to your nextcloud via the model context protocol. browse, search, and manage files through natural conversation.
Connect Claude AI to your Nextcloud via the Model Context Protocol. Browse, search, and manage files through natural conversation.
This server falls under the File Systems category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Connect Claude AI to your Nextcloud via the Model Context Pr
Use Cases
Maintainer
Works with
Installation
NPM
npx -y aiquila-mcpManual Installation
npx -y aiquila-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Aiquila
Aiquila connects Claude AI and other MCP-compatible assistants to a self-hosted Nextcloud instance, enabling natural-language file management, note creation, task handling, bookmark organisation, recipe queries, and document summarisation without opening a browser. It is available as an npx-launched MCP server for Claude Desktop and Claude Code, as a native Nextcloud app installable from within Nextcloud, and as a Docker deployment for remote access via Claude.ai. Teams running self-hosted Nextcloud gain AI-powered productivity features while keeping all data on their own infrastructure.
Prerequisites
- Node.js 20 or higher (for the npx MCP server path)
- A self-hosted Nextcloud instance that is network-accessible from your machine
- A Nextcloud app password generated from Settings > Security > Devices & Sessions (do not use your main login password)
- An MCP-compatible AI client such as Claude Desktop or Claude Code
Generate a Nextcloud app password
In your Nextcloud web interface, navigate to Settings (top-right avatar) > Security > Devices & Sessions. Enter a name like 'Claude MCP' and click 'Create new app password'. Copy the generated password — it will only be shown once.
Test the server from the command line
Run the MCP server once from a terminal to verify it connects to your Nextcloud instance before adding it to your AI client config.
NEXTCLOUD_URL=https://cloud.example.com \
NEXTCLOUD_USER=your-username \
NEXTCLOUD_PASSWORD=your-app-password \
npx -y aiquila-mcpAdd the server to Claude Desktop
Edit your claude_desktop_config.json to add Aiquila as an MCP server with the three required environment variables.
{
"mcpServers": {
"aiquila": {
"command": "npx",
"args": ["-y", "aiquila-mcp"],
"env": {
"NEXTCLOUD_URL": "https://cloud.example.com",
"NEXTCLOUD_USER": "your-username",
"NEXTCLOUD_PASSWORD": "your-app-password"
}
}
}
}Restart your MCP client
Restart Claude Desktop (or whichever MCP client you are using) for the new server configuration to take effect. The Aiquila tools should appear in the tool list.
Aiquila Examples
Client configuration
Complete claude_desktop_config.json entry for Aiquila with the three required Nextcloud connection variables.
{
"mcpServers": {
"aiquila": {
"command": "npx",
"args": ["-y", "aiquila-mcp"],
"env": {
"NEXTCLOUD_URL": "https://cloud.example.com",
"NEXTCLOUD_USER": "your-username",
"NEXTCLOUD_PASSWORD": "your-app-password"
}
}
}
}Prompts to try
Example prompts for Nextcloud file and data management via Aiquila.
- "List all files in my Nextcloud Documents folder"
- "Create a new note called 'Meeting Notes 2026-06-16' with the following content: ..."
- "Search my Nextcloud for any files containing 'Q2 budget'"
- "Show me my open tasks in Nextcloud and mark the first one as complete"
- "Summarise the document 'Project Proposal.docx' from my Nextcloud"Troubleshooting Aiquila
Authentication error: 401 Unauthorized
Confirm you are using a Nextcloud app password, not your regular account password. App passwords are generated in Nextcloud Settings > Security > Devices & Sessions. Regular passwords are rejected by the WebDAV/API endpoints that Aiquila uses.
Connection refused or timeout reaching Nextcloud
Check that NEXTCLOUD_URL is the full URL including https:// and without a trailing slash. Verify the Nextcloud instance is reachable from your machine with: curl -u your-username:your-app-password https://cloud.example.com/ocs/v1.php/cloud/capabilities
npx command not found or wrong Node.js version
Aiquila requires Node.js 20 or higher. Run 'node --version' to check. If you are below v20, install the latest LTS release from https://nodejs.org or use a version manager like nvm: 'nvm install 20 && nvm use 20'.
Frequently Asked Questions about Aiquila
What is Aiquila?
Aiquila is a Model Context Protocol (MCP) server that connect claude ai to your nextcloud via the model context protocol. browse, search, and manage files through natural conversation. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Aiquila?
Install via npm with the command: npx -y aiquila-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Aiquila?
Aiquila works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Aiquila free to use?
Yes, Aiquila is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Aiquila Alternatives — Similar File Systems Servers
Looking for alternatives to Aiquila? Here are other popular file systems servers you can use with Claude, Cursor, and VS Code.
Electerm
★ 14.1k📻Terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(linux, mac, win)
Plik
★ 1.8kPlik is a temporary file upload system (Wetransfer like) in Go.
Kordoc
★ 957An MCP server that parses South Korean document formats like HWP, HWPX, and PDF into Markdown. It features specialized table reconstruction and security-hardened extraction optimized for administrative and public institution files.
macOS Automator
★ 801A Model Context Protocol server that enables execution of AppleScript and JavaScript for Automation scripts on macOS, allowing programmatic control of applications and system functions through a rich knowledge base of pre-defined scripts.
PDF Reader
★ 723Enables reading, searching, and metadata extraction from PDF files without loading the entire content into the context window. It provides efficient tools for text cleaning, page-specific extraction, and context-aware search results.
Filesystem MCP Server
★ 643Provides comprehensive filesystem operations (read, write, list, create, delete, move files and directories) through the Model Context Protocol with Streamable HTTP transport and built-in security through configurable root directory restrictions.
Browse More File Systems MCP Servers
Explore all file systems servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Aiquila in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Aiquila?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.