AIquila — Nextcloud MCP Server

List files and folders in a Nextcloud directory

Read the contents of a file from Nextcloud

Create or update a file in Nextcloud. File size is limited (default 1 GB, configurable via MCP_MAX_FILE_SIZE).

Create a folder in Nextcloud

Delete a file or folder from Nextcloud

Move or rename a file or folder in Nextcloud

Copy a file or folder in Nextcloud

Get detailed file metadata from Nextcloud (name, size, mime type, modified date, permissions, etc.)

Search for files in Nextcloud by name pattern and/or mime type

Read file content from Nextcloud with mime type info. Returns text for text files, base64 for binary files (images, PDFs, etc.). Images are returned as MCP image content for Claude vision.

Analyze one or more images stored in Nextcloud using Claude vision. Ask questions about image content, extract text (OCR), describe visuals, compare images, or analyse documents. Supports up to 20 images for multi-image comparison.

Execute multiple file operations (move, copy, delete) sequentially in a single call. Returns per-item results.

Create a zip archive in Nextcloud from one or more files and/or folders. Runs server-side; not bound by MCP file-size limits.

Extract a zip archive in Nextcloud into a destination folder. Runs server-side.

List the contents of a zip archive in Nextcloud without extracting it.

Get Nextcloud system status including version, installation path, and configuration

Takes no parameters.

Run Nextcloud setup checks to verify system configuration (security, performance, PHP modules, etc.). Requires admin privileges

Takes no parameters.

Get the current local time and timezone of the MCP server. Call this to establish a time reference before creating or listing calendar events, or to resolve scheduling ambiguities with the user.

Takes no parameters.

List all installed Nextcloud apps with their enabled/disabled status. Requires admin privileges

Get detailed information about a specific Nextcloud app. Requires admin privileges

Enable a disabled Nextcloud app. Requires admin privileges

Disable an enabled Nextcloud app (preserves data but removes functionality). Requires admin privileges

Install a Nextcloud app from the App Store via occ app:install

Remove a Nextcloud app via occ app:remove

Get the personal tags assigned to a file or folder in Nextcloud

Set personal tags on a file or folder in Nextcloud. Replaces all existing personal tags. Use an empty array to clear all tags.

List all available system tags in Nextcloud with their IDs, names, and properties. Use this to find tag IDs before assigning them to files.

Takes no parameters.

Create a new system tag in Nextcloud. Returns the created tag info.

Assign a system tag to a file by file ID and tag ID. Use get_file_info to obtain the file ID.

Remove a system tag from a file by file ID and tag ID

Search across all Nextcloud apps (files, calendar, contacts, mail, notes, etc.) using Unified Search. Optionally filter by a specific provider ID. Without a provider, searches the top providers in parallel.

List all available Unified Search providers in Nextcloud. Use this to discover provider IDs for targeted searches with unified_search.

Takes no parameters.

List all users in the Nextcloud instance. Requires admin or sub-admin privileges

Get detailed information about a specific Nextcloud user. Non-admin users can only query their own user ID

Enable a disabled Nextcloud user account. Requires admin privileges

Disable a Nextcloud user account (prevents login but preserves data). Requires admin privileges

List all groups in the Nextcloud instance. Requires admin or sub-admin privileges

Get detailed information about a specific Nextcloud group. Requires admin or sub-admin privileges

Add a Nextcloud user to a group. Requires admin privileges

Remove a Nextcloud user from a group. Requires admin privileges

List file shares in Nextcloud (for diagnostics and security auditing)

Create a file or folder share in Nextcloud

Update an existing share in Nextcloud

Delete a share in Nextcloud

Get detailed information about a specific share by its ID

List all files and folders shared with the current user

Takes no parameters.

Search for valid share recipients (users, groups, emails, federated users, circles, rooms)

List pending federated/remote shares waiting to be accepted or declined

Takes no parameters.

Accept a pending federated/remote share

Decline a pending federated/remote share

Get a user's configured out-of-office / absence (NC 28+), whether it is active now or scheduled for later. The result includes firstDay and lastDay.

Set an out-of-office / absence period with status message (NC 28+)

Clear a user's out-of-office / absence status (NC 28+)

List files in the trash / recycle bin

Takes no parameters.

Restore a file from the trash to its original location (use the Key from list_trash)

Permanently delete all files in the trash (cannot be undone)

Takes no parameters.

List previous versions of a file (use get_file_info to find the fileId)

Restore a previous version of a file (creates a new current version from the old one)

Show current AIquila configuration. With targetProvider, list that provider's settings by id (the ids aiquila_configure's providerSettings takes); keys are never shown

Configure AIquila settings (API key, model, tokens, timeout, effort and thinking for chat and background tasks), and set up any LLM provider. Use targetProvider to configure a provider without making it the instance default; provider makes it the default. Run aiquila_show_config with targetProvider to list the setting ids a provider accepts.

Send a test prompt through the provider that serves a user (or the instance default), or through a named provider

Verify Nextcloud core system integrity by checking file signatures against the official release

Takes no parameters.

Verify integrity of a specific Nextcloud app by checking file signatures against its official release

Execute an allowlisted Nextcloud OCC command on the server and return the output. Only command and argument combinations in the allowlist may be run (configurable via MCP_OCC_ALLOWLIST env var). The default allows read-only commands only: status, app:list, setupchecks, integrity:check-core, integrity:check-app, user:list, user:info and group:list with any arguments; update:check, maintenance:mode and theming:config without arguments.

List all AIquila projects for the current user. Projects bundle files/directories with an optional system prompt.

Takes no parameters.

Create a new AIquila project. Projects bundle files/directories with an optional system prompt that gets injected into conversations.

Get details of an AIquila project including its file/directory paths.

Update an AIquila project. Only provided fields are updated.

Delete an AIquila project. Associated paths are removed and conversations referencing it are unlinked.

Add a file or directory path to an AIquila project.

Remove a file or directory path from an AIquila project.

List the AIquila prompt library: reusable prompts published by the organization and the user's own. Returns titles and descriptions; use get_prompt for the full text.

Takes no parameters.

Get the full text of a prompt from the AIquila prompt library.

List AIquila project templates: the organization's and the user's own. A template holds a title, description, system prompt and suggested paths.

Takes no parameters.

Create an AIquila project as a copy of a project template (title, description, system prompt and paths). Later changes to the template do not affect the project.

List the current user's coworkers (persistent scheduled AI tasks) with their status, provider, schedule and last run.

Takes no parameters.

List coworker templates — built-in ones (e.g. image classification via Claude vision or Mistral Pixtral) and any your administrator published for the organization — and the available task types.

Takes no parameters.

Get a single coworker by ID, including its schedule, last run status, full options and prompt.

Create a coworker. Provide templateId to start from a template (built-in, e.g. "classify-images-claude", or an organization one), and/or explicit fields to configure a custom one. Fields override template defaults.

Update a coworker's configuration (title, description, provider, input/output, schedule, prompt, tool allowlist, options). Only the given fields change; option changes are merged into the existing options.

Change when a coworker runs. Takes a 5-field cron expression in the server's time zone and returns the next run time.

Delete a coworker and its run history.

Enable a coworker so it runs on its schedule.

Disable a coworker so it stops running on its schedule.

Temporarily pause a coworker without disabling it.

Resume a paused coworker.

Run a coworker immediately (synchronously) and return the run result.

Stop a coworker's in-flight run (running or pending batch) and mark it cancelled. The schedule is untouched — use pause_coworker or disable_coworker to stop future runs.

Get recent run history (progress, status, summary) for a coworker. Use get_coworker_run for the full summary and log of one run.

Get one coworker run in full: status, duration, complete summary, error and its per-item log.

List all calendars available to the current user, including their supported component types (events, tasks, journals) and metadata.

Takes no parameters.

List events from a Nextcloud calendar within an optional time range. Returns event details including time, location, attendees, recurrence, and UIDs.

Get detailed information about a single calendar event by its UID, including full description, attendees, and recurrence rules.

Create a new calendar event in Nextcloud with date/time, location, description, attendees, and optional recurrence.

Update an existing calendar event's fields by UID. Uses CalDAV ETag-based optimistic concurrency.

Delete a calendar event from Nextcloud by UID. This action is irreversible.

List all task lists in Nextcloud Tasks (calendars that support tasks). Returns each list's display name, color, URL and calendarName (the value to pass to the other task tools). Set detailed for supported component types and the CTag.

List tasks from a Nextcloud Tasks calendar. Returns task details including status, priority, dates, tags, and UIDs.

Create a new task in Nextcloud Tasks with optional due date, start date, tags, location, and subtask relationships.

Update an existing task's fields by UID. Uses CalDAV ETag-based optimistic concurrency.

Delete a task from Nextcloud Tasks by UID. This action is irreversible.

Mark a task as completed or reopen it. Sets STATUS, PERCENT-COMPLETE, and COMPLETED date atomically.

List all address books available to the current user, including their display names and metadata.

Takes no parameters.

List contacts from a Nextcloud address book. Optionally search by name. Returns name, email, phone, organization, and UID for each contact.

Get detailed information about a single contact by its UID, including all properties like name, email, phone, address, organization, birthday, notes, and groups.

Create a new contact in a Nextcloud address book with name, email, phone, address, organization, and other properties.

Update an existing contact's fields by UID. Uses CardDAV ETag-based optimistic concurrency. Only provided fields are changed.

Delete a contact from a Nextcloud address book by UID. This action is irreversible.

List all notes in Nextcloud Notes. Returns id, title, category, favorite flag, and modification date.

Get the full content of a note by its ID.

Create a new note in Nextcloud Notes.

Update an existing note. Provide only the fields you want to change.

Delete a note by its ID.

List all RSS feeds subscribed in the Nextcloud News app, with unread counts.

Takes no parameters.

Subscribe to a new RSS feed by URL, optionally placing it in a folder.

Delete (unsubscribe from) a feed and all its items.

Move a feed into a different folder.

Rename a feed.

Mark all items in a feed as read up to (and including) the given newest item ID.

List all folders used to organize feeds in the Nextcloud News app.

Takes no parameters.

Create a new folder for organizing feeds in the News app.

Rename a News folder.

Delete a News folder and all feeds it contains.

Mark all items in a folder as read up to (and including) the given newest item ID.

List news articles (items). Filter by feed, folder, starred, or all; supports pagination and read/unread filtering.

Mark a single news item as read.

Mark a single news item as unread.

Star (favorite) a single news item.

Remove the star from a single news item.

Mark multiple news items as read in one call.

List all configured email accounts in Nextcloud Mail. Returns account IDs, names, and email addresses.

Takes no parameters.

List all mailboxes (folders) for a Nextcloud Mail account. Returns mailbox names, IDs, and unread counts.

List email messages in a Nextcloud Mail mailbox. Supports pagination via cursor. Returns subject, sender, date, and message IDs.

Read the full content of an email message by ID. Returns headers, body text, and attachment list.

Download an email attachment by message ID and attachment ID. Returns text for text files and calendar invites (ICS), image data for images, extracted text for PDFs (requires pdftotext). Attachment IDs are shown in mail_read_message output.

Search email messages across all mailboxes by subject or sender. Returns matches with message IDs usable in mail_read_message. For threaded conversations all message IDs in the thread are returned.

Send an email message through Nextcloud Mail. Requires an account ID and recipient addresses.

Delete an email message by ID. This typically moves it to trash.

Move an email message to a different mailbox/folder.

Set flags on an email message (mark as read/unread, star/unstar, mark as important or junk).

List all Deck boards. Returns id, title, owner, and label count for each board.

Takes no parameters.

Get details of a Deck board including its labels and access control list (ACL). Use deck_list_stacks to see the columns and cards.

Create a new Deck board.

List all stacks (columns) of a Deck board, including the cards in each stack. This gives a full overview of the board layout.

Create a new stack (column) on a Deck board.

Get full details of a Deck card including description, labels, and assigned users.

Create a new card in a Deck stack.

Update an existing Deck card. Provide only the fields you want to change. Fetches the current card first to preserve unchanged fields.

Move a card to a different stack (column) on the same board. This is the core kanban action for changing card status.

Archive or unarchive a Deck card.

Assign a label to a Deck card. Use deck_get_board to see available labels and their IDs.

Assign a user to a Deck card.

List all Passman password vaults. Returns name, guid, creation/last-access time and credential count. Note: secret values (password, username, url, etc.) are end-to-end encrypted and cannot be retrieved by this server.

Takes no parameters.

List credentials (metadata only) in a Passman vault. Returns each credential's label, id, guid and non-secret flags. Note: secret values (password, username, url, etc.) are end-to-end encrypted and cannot be retrieved by this server.

Get non-secret metadata for a single Passman credential (label, id, timestamps, flags). Note: secret values (password, username, url, etc.) are end-to-end encrypted and cannot be retrieved by this server.

List all recipes in Nextcloud Cookbook. Optionally filter by name, category, or keyword.

List all unique recipe categories found across recipes in Nextcloud Cookbook.

Takes no parameters.

Get full details of a recipe from Nextcloud Cookbook by its folder name.

Create a new recipe in Nextcloud Cookbook with schema.org Recipe format.

Update an existing recipe in Nextcloud Cookbook. Only provided fields are changed.

Delete a recipe from Nextcloud Cookbook. This removes the entire recipe folder including images. This action is irreversible.

List map favorites (saved locations/pins) from Nextcloud Maps. Optionally filter by modification time or scope to a custom map.

Create a new map favorite (saved location/pin) in Nextcloud Maps. Latitude and longitude are required.

Update an existing map favorite. Only provided fields are changed.

Delete a map favorite by its ID. This action is irreversible.

Rename one or more favorite categories. All favorites in the listed categories are moved to the new name.

List favorite categories that are shared via a public link.

Share a favorite category via a public link. The category must already contain at least one favorite.

Remove the public link share from a favorite category.

Add a shared favorite category to a custom map so its favorites show up there.

List GPS tracking devices registered in Nextcloud Maps.

Get GPS location points for a specific device. Supports time filtering and pagination.

Log a GPS location point for a device. The device is auto-created by user_agent if it doesn't exist.

Update a device's display color and/or name. At least one must be provided.

Delete a GPS tracking device and all its location points. This action is irreversible.

Share a GPS device via a public link, limited to a time window. Returns the share token.

List device shares that have been added to a custom map. Requires myMapId — the default map holds no device shares.

Revoke a device share by its token.

Add a shared device (by token) to a custom map so its track shows up there.

List GPS tracks (GPX/KML files) from Nextcloud Maps.

Get full details and content of a track by its ID. Returns metadata and the raw GPX/KML file content.

Update a track's color or metadata.

List geolocated photos (photos with GPS coordinates) from Nextcloud Maps.

List photos that don't have GPS coordinates. Useful for finding photos that can be placed on the map.

Set GPS coordinates on one or more photos. Each photo path is paired with a lat/lng.

Remove GPS coordinates from one or more photos.

Get the status of the background job that scans photos for GPS coordinates. Useful after uploading photos to see whether geolocation has finished.

Takes no parameters.

List address book contacts that carry a geographic address, as shown on the map.

Search address book contacts by name, to find the bookid/uri/uid needed to place a contact on the map.

Set a contact's geographic address and coordinates so it appears on the map. Use search_map_contacts to look up bookid, uri and uid.

Copy a contact into a custom map so it shows up as a pin on that map.

Remove an address and its coordinates from a contact, taking it off the map. The contact itself is kept. Use list_map_contacts to get the exact ADR and GEO values.

List all custom maps created by the user in Nextcloud Maps.

Takes no parameters.

Create a new custom map in Nextcloud Maps.

Update a custom map's properties (e.g. rename).

Delete a custom map. This action is irreversible.

Export a route or track as a GPX file to the user's Nextcloud /Maps folder.

Export favorites as a GPX file to the user's Nextcloud /Maps folder. Filter by categories and time range.

Import favorites from a file in Nextcloud storage. Supports GPX, KML, KMZ, JSON, and GeoJSON.

Export device location data as a GPX file to the user's Nextcloud /Maps folder.