AIquila — Nextcloud MCP Server

NPM · AIQUILA-MCP · 3 COMPONENTS · SCANNED AUG 4

Nextcloud MCP server — files, calendar, contacts, mail, maps, notes, tasks & 120+ more tools

Available components

remote · {hostname} 0 npm · aiquila-mcp 75 oci · ghcr.io/elgorro/aiquila-mcp:0.3.23 4

+35 this week 75 75 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (143 of 147), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (143 of 147), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency71

Repository check failed: the declared repository URL redirects; it must resolve directly. See how to fix → View diagnostics → Fail
Cryptographically verified build provenance (signed, bound to elgorro/aiquila). View diagnostics → Pass
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 2 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability77

AI-judged instruction clarity (excellent).Pass
Tool/resource definitions use about 19161 tokens (~64/item across 296 items; 296 tools + 0 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage99

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
96% of tool parameters carry a description.Partial

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · aiquila-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add elgorro-aiquila-mcp -- npx -y aiquila-mcp

# add to Codex CLI

codex mcp add elgorro-aiquila-mcp -- npx -y aiquila-mcp

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "elgorro-aiquila-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "aiquila-mcp"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add elgorro-aiquila-mcp --command npx --arg -y --arg aiquila-mcp

# ~/.hermes/config.yaml

mcp_servers:
  elgorro-aiquila-mcp:
    command: "npx"
    args: ["-y", "aiquila-mcp"]

// mcp.json

{
  "mcpServers": {
    "elgorro-aiquila-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "aiquila-mcp"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 +26
- CVE-2026-14257 no longer affects this package ▲ security
- Known CVEs: unverified → partial ▲ security
- Provenance: unverified → pass ▲ security
- Install scripts: unverified → pass ▲ security
- The attested source repository moved: elgorro/aiquila security
- Maintenance: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- License: unverified → pass ▲ functional
- Licence: MIT functional
2 Aug 26 +49
- Malware scan: unverified → pass ▲ security
- Stability: unverified → 0.23 ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- MCP protocol: unverified → pass ▲ functional
1 Aug 26 −30
- Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. security
- Tool coverage: 100 → unverified ▼ functional
- Capabilities: pass → unverified ▼ functional
31 Jul 26 +30
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 −83
- Known CVEs: fail → unverified ▼ security
- Provenance: pass → unverified ▼ security
- Malware scan: pass → unverified ▼ security
- Install scripts: pass → unverified ▼ security
- CVE-2026-14257 no longer affects this package ▲ security
- The attested source repository moved: elgorro/aiquila security
- Security disclosure: fail → unverified ▼ functional
- License: pass → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Dependency health: partial → unverified ▼ functional
- Maintenance: pass → unverified ▼ functional
- Licence: MIT functional
29 Jul 26 +64
- CVE-2026-14257 affects this package: high ▼ security
- Known CVEs: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Provenance: unverified → pass ▲ security
- The attested source repository moved: elgorro/aiquila security
- License: unverified → pass ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- Schema quality: unverified → excellent ▲ functional
- Maintenance: unverified → pass ▲ functional
- Licence: MIT functional
28 Jul 26 −21
- Tool coverage: 100 → unverified ▼ functional
- Dependency health: unverified → partial ▲ functional
- First check of Schema quality: unverified functional
27 Jul 26 40

First indexed and scored.

Show 3 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance verified

Ecosystem: npm · Outcome: verified

Reason: verified

Source repo:: elgorro/aiquila
Certificate issuer:: https://token.actions.githubusercontent.com
Certificate SAN:: https://github.com/elgorro/aiquila/.github/workflows/mcp-release.yml@refs/heads/main
Rekor log index:: 1883073812
Predicate type:: https://slsa.dev/provenance/v1
Subject digest:: sha512:9c9f916562dd30dc67ba9eeae0886e08911e7d33281211c7e3c8111d84c192fe5fb728fa3df399beee3026d43b7cbd2f3e9b0592d3e1cd76d8fb1e8ff
Discovery method:: attestation_endpoint

Dependencies 143 packages

143 packages in the resolved dependency tree · 142 deprecated · 51 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 296 exposed · ~19,161 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

mail_move_message ~51

Move an email message to a different mailbox/folder.

Input Output Examples

Name	Type	Req	Description
destMailboxId	number	yes	The destination mailbox ID (from list_mailboxes)
messageId	number	yes	The message ID to move

No output schema declared.

No examples provided.

mail_read_message ~45

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

Input Output Examples

Name	Type	Req	Description
messageId	number	yes	The message ID (from list_messages)

No output schema declared.

No examples provided.

mail_search_messages ~73

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.

Input Output Examples

Name	Type	Req	Description
limit	number	—	Max results (default: 10)
query	string	yes	Search query (matches subject and sender name)

No output schema declared.

No examples provided.

mail_send_message ~118

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

Input Output Examples

Name	Type	Req	Description
accountId	number	yes	The mail account ID to send from (from list_mail_accounts)
bcc	array	—	BCC email addresses
body	string	yes	Email body content (plain text)
cc	array	—	CC email addresses
isHtml	boolean	—	Whether the body is HTML (default: false)
subject	string	yes	Email subject line
to	array	yes	Recipient email addresses

No output schema declared.

No examples provided.

mail_set_message_flags ~57

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

Input Output Examples

Name	Type	Req	Description
flags	object	yes	Flags to set on the message
messageId	number	yes	The message ID

No output schema declared.

No examples provided.

mark_feed_read ~59

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

Input Output Examples

Name	Type	Req	Description
feedId	number	yes	The feed ID
newestItemId	number	yes	Mark all items with ID <= this value as read

No output schema declared.

No examples provided.

mark_item_read ~28

Mark a single news item as read.

Input Output Examples

Name	Type	Req	Description
itemId	number	yes	The item ID

No output schema declared.

No examples provided.

mark_item_unread ~29

Mark a single news item as unread.

Input Output Examples

Name	Type	Req	Description
itemId	number	yes	The item ID

No output schema declared.

No examples provided.

mark_items_read ~34

Mark multiple news items as read in one call.

Input Output Examples

Name	Type	Req	Description
itemIds	array	yes	The item IDs to mark as read

No output schema declared.

No examples provided.

mark_news_folder_read ~60

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

Input Output Examples

Name	Type	Req	Description
folderId	number	yes	The folder ID
newestItemId	number	yes	Mark all items with ID <= this value as read

No output schema declared.

No examples provided.

mark_notification_read ~33

Mark a notification as read (deletes it)

Input Output Examples

Name	Type	Req	Description
id	number	yes	The notification ID to mark as read

No output schema declared.

No examples provided.

move_feed ~44

Move a feed into a different folder.

Input Output Examples

Name	Type	Req	Description
feedId	number	yes	The feed ID to move
folderId	number	yes	Destination folder ID (0 for root)

No output schema declared.

No examples provided.

move_file ~61

Move or rename a file or folder in Nextcloud

Input Output Examples

Name	Type	Req	Description
destination	string	yes	The destination path
overwrite	boolean	—	Whether to overwrite if the destination already exists
source	string	yes	The source path of the file or folder to move

No output schema declared.

No examples provided.

pause_coworker ~32

Temporarily pause a coworker without disabling it.

Input Output Examples

Name	Type	Req	Description
id	number	yes	Coworker ID

No output schema declared.

No examples provided.

photos_add_collaborators ~56

Add collaborators (users or groups) to a photo album. Collaborators can view and add photos to the album.

Input Output Examples

Name	Type	Req	Description
albumName	string	yes	Album name
collaborators	array	yes	Array of collaborators to add

No output schema declared.

No examples provided.

photos_add_to_album ~78

Add one or more files to a photo album. Files are referenced by their Nextcloud path. The files themselves are not moved — only an album association is created.

Input Output Examples

Name	Type	Req	Description
albumName	string	yes	Album name
filePaths	array	yes	Array of file paths in Nextcloud (e.g., ["/Photos/sunset.jpg"])

No output schema declared.

No examples provided.

photos_create_album ~27

Create a new photo album.

Input Output Examples

Name	Type	Req	Description
name	string	yes	Name for the new album

No output schema declared.

No examples provided.

photos_delete_album ~40

Delete a photo album. This only removes the album — the underlying files are not deleted.

Input Output Examples

Name	Type	Req	Description
name	string	yes	Name of the album to delete

No output schema declared.

No examples provided.

photos_get_album ~46

Get details of a photo album including its files. Returns file IDs (needed for photos_remove_from_album), names, types, and sizes.

Input Output Examples

Name	Type	Req	Description
name	string	yes	Album name

No output schema declared.

No examples provided.

photos_get_metadata ~68

Get photo/video metadata (EXIF) for a file. Returns camera, lens, ISO, aperture, shutter speed, focal length, GPS coordinates, dimensions, and date taken when available.

Input Output Examples

Name	Type	Req	Description
path	string	yes	File path in Nextcloud (e.g., "/Photos/sunset.jpg")

No output schema declared.

No examples provided.

photos_list_albums ~33

List all photo albums owned by the current user. Returns album names, item counts, locations, and date ranges.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

photos_remove_from_album ~72

Remove one or more files from a photo album by file ID (use photos_get_album to find IDs). This only removes the album association — the files are not deleted.

Input Output Examples

Name	Type	Req	Description
albumName	string	yes	Album name
fileIds	array	yes	File IDs to remove (from photos_get_album output)

No output schema declared.

No examples provided.

photos_rename_album ~36

Rename a photo album.

Input Output Examples

Name	Type	Req	Description
name	string	yes	Current album name
newName	string	yes	New album name

No output schema declared.

No examples provided.

photos_set_album_location ~47

Set or update the location metadata on a photo album.

Input Output Examples

Name	Type	Req	Description
location	string	yes	Location string (e.g., "Paris, France")
name	string	yes	Album name

No output schema declared.

No examples provided.

photos_set_favorite ~57

Mark or unmark a file as favorite.

Input Output Examples

Name	Type	Req	Description
favorite	boolean	yes	true to mark as favorite, false to unmark
path	string	yes	File path in Nextcloud (e.g., "/Photos/sunset.jpg")

No output schema declared.

No examples provided.

place_map_photos ~86

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

Input Output Examples

Name	Type	Req	Description
lats	array	yes	Latitudes (parallel to paths)
lngs	array	yes	Longitudes (parallel to paths)
myMapId	number	—	Custom map ID to scope to
paths	array	yes	File paths in Nextcloud storage

No output schema declared.

No examples provided.

process_text ~140

Submit a text-processing task to Nextcloud's AI framework and return the task ID. Use get_task_result to poll until it completes. Common task types: 'core:text2text' (free prompt), 'core:summarize' (summary), 'core:headline' (headline), 'core:extract_topics' (topics).

Input Output Examples

Name	Type	Req	Description
customId	string	—	Optional identifier to tag the task for later retrieval
input	string	yes	The text to process
taskType	string	yes	Task type ID (e.g. 'core:summarize', 'core:headline', 'core:extract_topics', 'core:text2text')

No output schema declared.

No examples provided.

read_file ~31

Read the contents of a file from Nextcloud

Input Output Examples

Name	Type	Req	Description
path	string	yes	The file path in Nextcloud

No output schema declared.

No examples provided.

read_text_workspace ~62

Read the content of a folder's Text workspace file (Readme.md). Returns markdown text, or a 'no workspace' message if none exists.

Input Output Examples

Name	Type	Req	Description
path	string	yes	Folder path relative to the user's root (e.g. '/Projects/Acme')

No output schema declared.

No examples provided.

remove_project_path ~42

Remove a file or directory path from an AIquila project.

Input Output Examples

Name	Type	Req	Description
id	number	yes	Project ID
pathId	number	yes	Path ID to remove

No output schema declared.

No examples provided.

remove_system_tag ~50

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

Input Output Examples

Name	Type	Req	Description
fileId	number	yes	The Nextcloud file ID
tagId	number	yes	The system tag ID to remove

No output schema declared.

No examples provided.

remove_user_from_group ~62

Remove a Nextcloud user from a group. Requires admin privileges

Input Output Examples

Name	Type	Req	Description
groupId	string	yes	The group ID (name) to remove the user from
userId	string	yes	The user ID (login name) to remove from the group

No output schema declared.

No examples provided.

rename_bookmark_tag ~47

Rename a bookmark tag. All bookmarks with the old tag will be updated.

Input Output Examples

Name	Type	Req	Description
new_name	string	yes	New tag name
old_name	string	yes	Current tag name

No output schema declared.

No examples provided.

rename_feed ~37

Rename a feed.

Input Output Examples

Name	Type	Req	Description
feedId	number	yes	The feed ID to rename
feedTitle	string	yes	The new feed title

No output schema declared.

No examples provided.

rename_news_folder ~38

Rename a News folder.

Input Output Examples

Name	Type	Req	Description
folderId	number	yes	The folder ID to rename
name	string	yes	The new folder name

No output schema declared.

No examples provided.

reopen_poll ~29

Reopen a previously closed poll so voting can resume.

Input Output Examples

Name	Type	Req	Description
pollId	integer	yes	Poll ID

No output schema declared.

No examples provided.

reorder_form_options ~66

Reorder all options for a choice question. Pass the full list of option IDs in the desired order.

Input Output Examples

Name	Type	Req	Description
formId	integer	yes	Form ID
newOrder	array	yes	Full list of option IDs in desired order
questionId	integer	yes	Question ID

No output schema declared.

No examples provided.

reorder_form_questions ~55

Reorder all questions in a form. Pass the full list of question IDs in the desired order.

Input Output Examples

Name	Type	Req	Description
formId	integer	yes	Form ID
newOrder	array	yes	Full list of question IDs in desired order

No output schema declared.

No examples provided.

reset_map_photo_coords ~47

Remove GPS coordinates from one or more photos.

Input Output Examples

Name	Type	Req	Description
myMapId	number	—	Custom map ID to scope to
paths	array	yes	File paths in Nextcloud storage

No output schema declared.

No examples provided.

reset_registration_setting ~52

Reset a Nextcloud Registration app setting to its default by deleting the stored value. Requires the configured Nextcloud user to be an admin.

Input Output Examples

Name	Type	Req	Description
key	string	yes	The Registration config key to reset to its default

No output schema declared.

No examples provided.

reset_terms_signatures ~52

Reset ALL users' terms of service signatures org-wide, forcing every user to accept the terms again on next login. This is destructive and cannot be undone. Requires the configured Nextcloud user to be an admin.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

restore_file_version ~58

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

Input Output Examples

Name	Type	Req	Description
fileId	number	yes	The Nextcloud internal file ID
versionId	string	yes	The version identifier (from list_file_versions output)

No output schema declared.

No examples provided.

restore_from_trash ~51

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

Input Output Examples

Name	Type	Req	Description
trashKey	string	yes	The trash item key (from the Key field in list_trash output)

No output schema declared.

No examples provided.

resume_coworker ~28

Resume a paused coworker.

Input Output Examples

Name	Type	Req	Description
id	number	yes	Coworker ID

No output schema declared.

No examples provided.

run_coworker ~37

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

Input Output Examples

Name	Type	Req	Description
id	number	yes	Coworker ID

No output schema declared.

No examples provided.

run_occ ~215

Execute an allowlisted Nextcloud OCC command on the server and return the output. Only commands in the allowlist may be run (configurable via MCP_OCC_ALLOWLIST env var). Allowed by default: status, app:list, app:check-code, config:app:get, setupchecks, integrity:check-core, integrity:check-app, user:list, user:info, group:list, maintenance:mode, maintenance:mimetype:update-db, db:add-missing-indices, db:add-missing-columns, db:add-missing-primary-keys, files:scan, files:cleanup, trashbin:cleanup, update:check, notification:generate, theming:config.

Input Output Examples

Name	Type	Req	Description
args	array	—	Optional arguments for the command (e.g., ["--shipped=false", "--output=json"])
command	string	yes	The OCC command to execute (e.g., "app:list", "config:list", "setupchecks")
timeout	number	—	Timeout in seconds (default: 120, max: 600)

No output schema declared.

No examples provided.

run_setup_checks ~32

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

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

search_files ~69

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

Input Output Examples

Name	Type	Req	Description
mime	string	—	Filter by mime type prefix (e.g., 'image/', 'text/plain')
path	string	—	Base directory to search in
query	string	yes	Search query (file name pattern)

No output schema declared.

No examples provided.

search_sharees ~115

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

Input Output Examples

Name	Type	Req	Description
itemType	string	—	Item type (default: file)
search	string	yes	Search query for recipient name/email
shareTypes	array	—	Share types to include: 0=user, 1=group, 3=public, 4=email, 6=federated, 7=circle, 10=room (default: [0,1,3,4,6])

No output schema declared.

No examples provided.

set_file_tags ~83

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

Input Output Examples

Name	Type	Req	Description
path	string	yes	The file or folder path in Nextcloud (e.g., '/Photos/test.png')
tags	array	yes	Array of tag names to set (e.g., ['Wallpapers', 'Nature'])

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug