All servers / Productivity / Nextcloud MCP server
Nextcloud MCP server
Nextcloud MCP server — 384 tools: files, calendar, contacts, mail, Talk, Deck, photos, maps, notes
Tested by ConnectATDScore 84 out of 100. Tested 2026-11-19 on package version 0.5.4. Package: aiquila-mcp · source
Score breakdown
| Runs | 18 / 20 | |
|---|---|---|
| Tool descriptions | 18 / 20 | |
| Package safety | 20 / 20 | |
| Maintenance | 20 / 20 | |
| Adoption | 8 / 20 |
What we saw
- Starts and answers the MCP handshake: yes (4.0 seconds including download)
- Tools offered: 316
- Last published: 2026-11-14
- Weekly downloads (npm): 603
- License: MIT · Direct dependencies: 9
Want this server set up for your team?
ConnectATD builds AI automation and wires up MCP servers like this one. Tell us what you are trying to do.
Talk to ConnectATDTools and how they are described
Agents choose tools from these descriptions. Under each name you can see how many of its parameters are explained.
list_files1 of 1 parameter describedList files and folders in a Nextcloud directory
read_file1 of 1 parameter describedRead the contents of a file from Nextcloud
write_file2 of 2 parameters describedCreate or update a file in Nextcloud. File size is limited (default 1 GB, configurable via MCP_MAX_FILE_SIZE).
create_folder1 of 1 parameter describedCreate a folder in Nextcloud
delete1 of 1 parameter describedDelete a file or folder from Nextcloud
move_file3 of 3 parameters describedMove or rename a file or folder in Nextcloud
copy_file3 of 3 parameters describedCopy a file or folder in Nextcloud
get_file_info1 of 1 parameter describedGet detailed file metadata from Nextcloud (name, size, mime type, modified date, permissions, etc.)
search_files3 of 3 parameters describedSearch for files in Nextcloud by name pattern and/or mime type
get_file_content1 of 1 parameter describedRead 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_image3 of 3 parameters describedAnalyze 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.
bulk_file_operations1 of 1 parameter describedExecute multiple file operations (move, copy, delete) sequentially in a single call. Returns per-item results.
create_archive3 of 3 parameters describedCreate a zip archive in Nextcloud from one or more files and/or folders. Runs server-side; not bound by MCP file-size limits.
extract_archive3 of 3 parameters describedExtract a zip archive in Nextcloud into a destination folder. Runs server-side.
list_archive1 of 1 parameter describedList the contents of a zip archive in Nextcloud without extracting it.
system_statusno parametersGet Nextcloud system status including version, installation path, and configuration
run_setup_checksno parametersRun Nextcloud setup checks to verify system configuration (security, performance, PHP modules, etc.). Requires admin privileges
get_local_timeno parametersGet 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.
list_apps1 of 1 parameter describedList all installed Nextcloud apps with their enabled/disabled status. Requires admin privileges
get_app_info1 of 1 parameter describedGet detailed information about a specific Nextcloud app. Requires admin privileges
enable_app1 of 1 parameter describedEnable a disabled Nextcloud app. Requires admin privileges
disable_app1 of 1 parameter describedDisable an enabled Nextcloud app (preserves data but removes functionality). Requires admin privileges
install_app2 of 2 parameters describedInstall a Nextcloud app from the App Store via occ app:install
uninstall_app2 of 2 parameters describedRemove a Nextcloud app via occ app:remove
get_file_tags1 of 1 parameter describedGet the personal tags assigned to a file or folder in Nextcloud
set_file_tags2 of 2 parameters describedSet personal tags on a file or folder in Nextcloud. Replaces all existing personal tags. Use an empty array to clear all tags.
list_system_tagsno parametersList all available system tags in Nextcloud with their IDs, names, and properties. Use this to find tag IDs before assigning them to files.
create_system_tag3 of 3 parameters describedCreate a new system tag in Nextcloud. Returns the created tag info.
assign_system_tag2 of 2 parameters describedAssign a system tag to a file by file ID and tag ID. Use get_file_info to obtain the file ID.
remove_system_tag2 of 2 parameters describedRemove a system tag from a file by file ID and tag ID
unified_search4 of 4 parameters describedSearch 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_search_providersno parametersList all available Unified Search providers in Nextcloud. Use this to discover provider IDs for targeted searches with unified_search.
list_users3 of 3 parameters describedList all users in the Nextcloud instance. Requires admin or sub-admin privileges
get_user_info1 of 1 parameter describedGet detailed information about a specific Nextcloud user. Non-admin users can only query their own user ID
enable_user1 of 1 parameter describedEnable a disabled Nextcloud user account. Requires admin privileges
disable_user1 of 1 parameter describedDisable a Nextcloud user account (prevents login but preserves data). Requires admin privileges
list_groups3 of 3 parameters describedList all groups in the Nextcloud instance. Requires admin or sub-admin privileges
get_group_info1 of 1 parameter describedGet detailed information about a specific Nextcloud group. Requires admin or sub-admin privileges
add_user_to_group2 of 2 parameters describedAdd a Nextcloud user to a group. Requires admin privileges
remove_user_from_group2 of 2 parameters describedRemove a Nextcloud user from a group. Requires admin privileges
list_shares3 of 3 parameters describedList file shares in Nextcloud (for diagnostics and security auditing)
create_share9 of 9 parameters describedCreate a file or folder share in Nextcloud
update_share7 of 7 parameters describedUpdate an existing share in Nextcloud
delete_share1 of 1 parameter describedDelete a share in Nextcloud
get_share1 of 1 parameter describedGet detailed information about a specific share by its ID
list_shares_with_meno parametersList all files and folders shared with the current user
search_sharees3 of 3 parameters describedSearch for valid share recipients (users, groups, emails, federated users, circles, rooms)
list_pending_sharesno parametersList pending federated/remote shares waiting to be accepted or declined
accept_pending_share1 of 1 parameter describedAccept a pending federated/remote share
decline_pending_share1 of 1 parameter describedDecline a pending federated/remote share
get_out_of_office1 of 1 parameter describedGet a user's current out-of-office / absence status (NC 28+)
set_out_of_office6 of 6 parameters describedSet an out-of-office / absence period with status message (NC 28+)
clear_out_of_office1 of 1 parameter describedClear a user's out-of-office / absence status (NC 28+)
list_trashno parametersList files in the trash / recycle bin
restore_from_trash1 of 1 parameter describedRestore a file from the trash to its original location (use the Key from list_trash)
empty_trashno parametersPermanently delete all files in the trash (cannot be undone)
list_file_versions1 of 1 parameter describedList previous versions of a file (use get_file_info to find the fileId)
restore_file_version2 of 2 parameters describedRestore a previous version of a file (creates a new current version from the old one)
aiquila_show_configno parametersShow current AIquila configuration
aiquila_configure4 of 4 parameters describedConfigure AIquila settings (API key, model, tokens, timeout)
aiquila_test1 of 1 parameter describedTest AIquila Claude API integration with a simple prompt
check_core_integrityno parametersVerify Nextcloud core system integrity by checking file signatures against the official release
check_app_integrity1 of 1 parameter describedVerify integrity of a specific Nextcloud app by checking file signatures against its official release
run_occ3 of 3 parameters describedExecute 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.
list_projectsno parametersList all AIquila projects for the current user. Projects bundle files/directories with an optional system prompt.
create_project3 of 3 parameters describedCreate a new AIquila project. Projects bundle files/directories with an optional system prompt that gets injected into conversations.
get_project1 of 1 parameter describedGet details of an AIquila project including its file/directory paths.
update_project4 of 4 parameters describedUpdate an AIquila project. Only provided fields are updated.
delete_project1 of 1 parameter describedDelete an AIquila project. Associated paths are removed and conversations referencing it are unlinked.
add_project_path3 of 3 parameters describedAdd a file or directory path to an AIquila project.
remove_project_path2 of 2 parameters describedRemove a file or directory path from an AIquila project.
list_coworkersno parametersList the current user's coworkers (persistent scheduled AI tasks) with their status, provider, schedule and last run.
list_coworker_templatesno parametersList built-in coworker templates (e.g. image classification via Claude vision or Mistral Pixtral) and available task types.
get_coworker1 of 1 parameter describedGet a single coworker by ID, including its schedule and last run status.
create_coworker9 of 10 parameters describedCreate a coworker. Provide templateId to start from a built-in template (e.g. "classify-images-claude" or "classify-images-mistral"), and/or explicit fields to configure a custom one. Fields override template defaults.
update_coworker3 of 8 parameters describedUpdate a coworker's configuration (title, provider, input folder, schedule, options).
delete_coworker1 of 1 parameter describedDelete a coworker and its run history.
enable_coworker1 of 1 parameter describedEnable a coworker so it runs on its schedule.
disable_coworker1 of 1 parameter describedDisable a coworker so it stops running on its schedule.
pause_coworker1 of 1 parameter describedTemporarily pause a coworker without disabling it.
resume_coworker1 of 1 parameter describedResume a paused coworker.
run_coworker1 of 1 parameter describedRun a coworker immediately (synchronously) and return the run result.
get_coworker_runs2 of 2 parameters describedGet recent run history (progress, status, summary) for a coworker.
list_calendarsno parametersList all calendars available to the current user, including their supported component types (events, tasks, journals) and metadata.
list_events4 of 4 parameters describedList events from a Nextcloud calendar within an optional time range. Returns event details including time, location, attendees, recurrence, and UIDs.
get_event2 of 2 parameters describedGet detailed information about a single calendar event by its UID, including full description, attendees, and recurrence rules.
create_event15 of 15 parameters describedCreate a new calendar event in Nextcloud with date/time, location, description, attendees, and optional recurrence.
update_event16 of 16 parameters describedUpdate an existing calendar event's fields by UID. Uses CalDAV ETag-based optimistic concurrency.
delete_event2 of 2 parameters describedDelete a calendar event from Nextcloud by UID. This action is irreversible.
list_task_listsno parametersList all task lists in Nextcloud Tasks
list_tasks2 of 2 parameters describedList tasks from a Nextcloud Tasks calendar. Returns task details including status, priority, dates, tags, and UIDs.
create_task12 of 12 parameters describedCreate a new task in Nextcloud Tasks with optional due date, start date, tags, location, and subtask relationships.
update_task15 of 15 parameters describedUpdate an existing task's fields by UID. Uses CalDAV ETag-based optimistic concurrency.
delete_task2 of 2 parameters describedDelete a task from Nextcloud Tasks by UID. This action is irreversible.
complete_task3 of 3 parameters describedMark a task as completed or reopen it. Sets STATUS, PERCENT-COMPLETE, and COMPLETED date atomically.
list_address_booksno parametersList all address books available to the current user, including their display names and metadata.
list_contacts3 of 3 parameters describedList contacts from a Nextcloud address book. Optionally search by name. Returns name, email, phone, organization, and UID for each contact.
get_contact2 of 2 parameters describedGet detailed information about a single contact by its UID, including all properties like name, email, phone, address, organization, birthday, notes, and groups.
create_contact15 of 15 parameters describedCreate a new contact in a Nextcloud address book with name, email, phone, address, organization, and other properties.
update_contact14 of 14 parameters describedUpdate an existing contact's fields by UID. Uses CardDAV ETag-based optimistic concurrency. Only provided fields are changed.
delete_contact2 of 2 parameters describedDelete a contact from a Nextcloud address book by UID. This action is irreversible.
list_notes2 of 2 parameters describedList all notes in Nextcloud Notes. Returns id, title, category, favorite flag, and modification date.
get_note1 of 1 parameter describedGet the full content of a note by its ID.
create_note4 of 4 parameters describedCreate a new note in Nextcloud Notes.
update_note5 of 5 parameters describedUpdate an existing note. Provide only the fields you want to change.
delete_note1 of 1 parameter describedDelete a note by its ID.
list_feedsno parametersList all RSS feeds subscribed in the Nextcloud News app, with unread counts.
add_feed2 of 2 parameters describedSubscribe to a new RSS feed by URL, optionally placing it in a folder.
delete_feed1 of 1 parameter describedDelete (unsubscribe from) a feed and all its items.
move_feed2 of 2 parameters describedMove a feed into a different folder.
rename_feed2 of 2 parameters describedRename a feed.
mark_feed_read2 of 2 parameters describedMark all items in a feed as read up to (and including) the given newest item ID.
list_news_foldersno parametersList all folders used to organize feeds in the Nextcloud News app.
create_news_folder1 of 1 parameter describedCreate a new folder for organizing feeds in the News app.
rename_news_folder2 of 2 parameters describedRename a News folder.
delete_news_folder1 of 1 parameter describedDelete a News folder and all feeds it contains.
mark_news_folder_read2 of 2 parameters describedMark all items in a folder as read up to (and including) the given newest item ID.
list_news_items6 of 6 parameters describedList news articles (items). Filter by feed, folder, starred, or all; supports pagination and read/unread filtering.
mark_item_read1 of 1 parameter describedMark a single news item as read.
mark_item_unread1 of 1 parameter describedMark a single news item as unread.
star_item1 of 1 parameter describedStar (favorite) a single news item.
unstar_item1 of 1 parameter describedRemove the star from a single news item.
mark_items_read1 of 1 parameter describedMark multiple news items as read in one call.
list_mail_accountsno parametersList all configured email accounts in Nextcloud Mail. Returns account IDs, names, and email addresses.
list_mailboxes1 of 1 parameter describedList all mailboxes (folders) for a Nextcloud Mail account. Returns mailbox names, IDs, and unread counts.
mail_list_messages4 of 4 parameters describedList email messages in a Nextcloud Mail mailbox. Supports pagination via cursor. Returns subject, sender, date, and message IDs.
mail_read_message1 of 1 parameter describedRead the full content of an email message by ID. Returns headers, body text, and attachment list.
mail_get_attachment2 of 2 parameters describedDownload 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.
mail_search_messages2 of 2 parameters describedSearch 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.
mail_send_message7 of 7 parameters describedSend an email message through Nextcloud Mail. Requires an account ID and recipient addresses.
mail_delete_message1 of 1 parameter describedDelete an email message by ID. This typically moves it to trash.
mail_move_message2 of 2 parameters describedMove an email message to a different mailbox/folder.
mail_set_message_flags2 of 2 parameters describedSet flags on an email message (mark as read/unread, star/unstar, mark as important or junk).
deck_list_boardsno parametersList all Deck boards. Returns id, title, owner, and label count for each board.
deck_get_board1 of 1 parameter describedGet details of a Deck board including its labels and access control list (ACL). Use deck_list_stacks to see the columns and cards.
deck_create_board2 of 2 parameters describedCreate a new Deck board.
deck_list_stacks1 of 1 parameter describedList all stacks (columns) of a Deck board, including the cards in each stack. This gives a full overview of the board layout.
deck_create_stack3 of 3 parameters describedCreate a new stack (column) on a Deck board.
deck_get_card3 of 3 parameters describedGet full details of a Deck card including description, labels, and assigned users.
deck_create_card5 of 5 parameters describedCreate a new card in a Deck stack.
deck_update_card7 of 7 parameters describedUpdate an existing Deck card. Provide only the fields you want to change. Fetches the current card first to preserve unchanged fields.
deck_move_card5 of 5 parameters describedMove a card to a different stack (column) on the same board. This is the core kanban action for changing card status.
deck_archive_card4 of 4 parameters describedArchive or unarchive a Deck card.
deck_assign_label4 of 4 parameters describedAssign a label to a Deck card. Use deck_get_board to see available labels and their IDs.
deck_assign_user4 of 4 parameters describedAssign a user to a Deck card.
passman_list_vaultsno parametersList 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.
passman_list_credentials1 of 1 parameter describedList 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.
passman_get_credential_info2 of 2 parameters describedGet 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_recipes3 of 3 parameters describedList all recipes in Nextcloud Cookbook. Optionally filter by name, category, or keyword.
list_recipe_categoriesno parametersList all unique recipe categories found across recipes in Nextcloud Cookbook.
get_recipe1 of 1 parameter describedGet full details of a recipe from Nextcloud Cookbook by its folder name.
create_recipe14 of 14 parameters describedCreate a new recipe in Nextcloud Cookbook with schema.org Recipe format.
update_recipe15 of 15 parameters describedUpdate an existing recipe in Nextcloud Cookbook. Only provided fields are changed.
delete_recipe1 of 1 parameter describedDelete a recipe from Nextcloud Cookbook. This removes the entire recipe folder including images. This action is irreversible.
list_map_favorites2 of 2 parameters describedList map favorites (saved locations/pins) from Nextcloud Maps. Optionally filter by modification time or scope to a custom map.
create_map_favorite7 of 7 parameters describedCreate a new map favorite (saved location/pin) in Nextcloud Maps. Latitude and longitude are required.
update_map_favorite8 of 8 parameters describedUpdate an existing map favorite. Only provided fields are changed.
delete_map_favorite2 of 2 parameters describedDelete a map favorite by its ID. This action is irreversible.
rename_map_favorite_category3 of 3 parameters describedRename one or more favorite categories. All favorites in the listed categories are moved to the new name.
list_shared_map_categories1 of 1 parameter describedList favorite categories that are shared via a public link.
share_map_category1 of 1 parameter describedShare a favorite category via a public link. The category must already contain at least one favorite.
unshare_map_category1 of 1 parameter describedRemove the public link share from a favorite category.
add_shared_category_to_map3 of 3 parameters describedAdd a shared favorite category to a custom map so its favorites show up there.
list_map_devices1 of 1 parameter describedList GPS tracking devices registered in Nextcloud Maps.
get_map_device_points4 of 4 parameters describedGet GPS location points for a specific device. Supports time filtering and pagination.
add_map_device_point7 of 7 parameters describedLog a GPS location point for a device. The device is auto-created by user_agent if it doesn't exist.
update_map_device3 of 3 parameters describedUpdate a device's display color and/or name. At least one must be provided.
delete_map_device1 of 1 parameter describedDelete a GPS tracking device and all its location points. This action is irreversible.
share_map_device3 of 3 parameters describedShare a GPS device via a public link, limited to a time window. Returns the share token.
list_shared_map_devices1 of 1 parameter describedList device shares that have been added to a custom map. Requires myMapId — the default map holds no device shares.
remove_map_device_share1 of 1 parameter describedRevoke a device share by its token.
add_shared_device_to_map2 of 2 parameters describedAdd a shared device (by token) to a custom map so its track shows up there.
list_map_tracks1 of 1 parameter describedList GPS tracks (GPX/KML files) from Nextcloud Maps.
get_map_track1 of 1 parameter describedGet full details and content of a track by its ID. Returns metadata and the raw GPX/KML file content.
update_map_track4 of 4 parameters describedUpdate a track's color or metadata.
list_map_photos1 of 1 parameter describedList geolocated photos (photos with GPS coordinates) from Nextcloud Maps.
list_map_photos_nonlocalized4 of 4 parameters describedList photos that don't have GPS coordinates. Useful for finding photos that can be placed on the map.
place_map_photos4 of 4 parameters describedSet GPS coordinates on one or more photos. Each photo path is paired with a lat/lng.
reset_map_photo_coords2 of 2 parameters describedRemove GPS coordinates from one or more photos.
get_map_photo_job_statusno parametersGet the status of the background job that scans photos for GPS coordinates. Useful after uploading photos to see whether geolocation has finished.
list_map_contacts1 of 1 parameter describedList address book contacts that carry a geographic address, as shown on the map.
search_map_contacts1 of 1 parameter describedSearch address book contacts by name, to find the bookid/uri/uid needed to place a contact on the map.
place_map_contact15 of 15 parameters describedSet a contact's geographic address and coordinates so it appears on the map. Use search_map_contacts to look up bookid, uri and uid.
add_contact_to_map3 of 3 parameters describedCopy a contact into a custom map so it shows up as a pin on that map.
delete_map_contact_address6 of 6 parameters describedRemove 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_mapsno parametersList all custom maps created by the user in Nextcloud Maps.
create_map1 of 1 parameter describedCreate a new custom map in Nextcloud Maps.
update_map2 of 2 parameters describedUpdate a custom map's properties (e.g. rename).
delete_map1 of 1 parameter describedDelete a custom map. This action is irreversible.
export_map_route6 of 6 parameters describedExport a route or track as a GPX file to the user's Nextcloud /Maps folder.
export_map_favorites4 of 4 parameters describedExport favorites as a GPX file to the user's Nextcloud /Maps folder. Filter by categories and time range.
import_map_favorites1 of 1 parameter describedImport favorites from a file in Nextcloud storage. Supports GPX, KML, KMZ, JSON, and GeoJSON.
export_map_devices4 of 4 parameters describedExport device location data as a GPX file to the user's Nextcloud /Maps folder.
import_map_devices1 of 1 parameter describedImport device location data from a file in Nextcloud storage. Supports GPX, KML, and KMZ.
photos_list_albumsno parametersList all photo albums owned by the current user. Returns album names, item counts, locations, and date ranges.
photos_get_album1 of 1 parameter describedGet details of a photo album including its files. Returns file IDs (needed for photos_remove_from_album), names, types, and sizes.
photos_create_album1 of 1 parameter describedCreate a new photo album.
photos_delete_album1 of 1 parameter describedDelete a photo album. This only removes the album — the underlying files are not deleted.
photos_rename_album2 of 2 parameters describedRename a photo album.
photos_add_to_album2 of 2 parameters describedAdd 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.
photos_remove_from_album2 of 2 parameters describedRemove 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.
photos_get_metadata1 of 1 parameter describedGet photo/video metadata (EXIF) for a file. Returns camera, lens, ISO, aperture, shutter speed, focal length, GPS coordinates, dimensions, and date taken when available.
photos_set_favorite2 of 2 parameters describedMark or unmark a file as favorite.
photos_set_album_location2 of 2 parameters describedSet or update the location metadata on a photo album.
photos_add_collaborators2 of 2 parameters describedAdd collaborators (users or groups) to a photo album. Collaborators can view and add photos to the album.
talk_list_conversations1 of 1 parameter describedList all Talk conversations the user has access to. Returns conversation tokens, names, types, and unread message counts.
talk_list_messages4 of 4 parameters describedList recent messages in a Talk conversation. Returns message content with timestamps and authors.
talk_send_message4 of 4 parameters describedSend a message to a Talk conversation. Supports replies and silent messages that do not trigger notifications.
talk_create_conversation3 of 3 parameters describedCreate a new Talk conversation. One-on-one requires an invite user, group/public require a name.
talk_list_participants1 of 1 parameter describedList all participants in a Talk conversation with their roles.
talk_add_participant3 of 3 parameters describedAdd a user, group, or email participant to a Talk conversation.
talk_remove_participant2 of 2 parameters describedRemove a participant from a Talk conversation by their attendee ID (from list_participants).
talk_delete_message2 of 2 parameters describedDelete a message from a Talk conversation.
talk_create_poll5 of 5 parameters describedCreate a poll in a Talk conversation. Requires at least 2 options.
talk_react_to_message3 of 3 parameters describedAdd an emoji reaction to a message in a Talk conversation.
circles_list2 of 2 parameters describedList all circles/teams accessible to the current user. Returns circle IDs, names, owners, and configuration.
circles_get1 of 1 parameter describedGet detailed information about a specific circle/team, including its description, owner, and configuration flags.
circles_create3 of 3 parameters describedCreate a new circle/team. The current user becomes the owner. Set personal=true for a private circle only visible to the owner.
circles_delete1 of 1 parameter describedDelete a circle/team. Requires owner privileges.
circles_list_members1 of 1 parameter describedList all members of a circle/team. Returns member IDs (needed for removal), user IDs, types, and permission levels.
circles_add_member3 of 3 parameters describedAdd a member to a circle/team. Requires moderator privileges or higher. Member type: 1=user (default), 2=group, 4=mail, 16=circle.
circles_remove_member2 of 2 parameters describedRemove a member from a circle/team. Use circles_list_members to get the memberId. Requires moderator privileges or higher.
circles_search1 of 1 parameter describedSearch for circles/teams by name.
list_bookmarks8 of 8 parameters describedList bookmarks from Nextcloud Bookmarks app. Supports search, tag filtering, folder filtering, sorting, and pagination.
get_bookmark1 of 1 parameter describedGet full details of a single bookmark by its ID.
create_bookmark5 of 5 parameters describedCreate a new bookmark in Nextcloud Bookmarks. URL is required; title, description, tags, and folders are optional.
update_bookmark6 of 6 parameters describedUpdate an existing bookmark. Only provided fields are changed.
delete_bookmark1 of 1 parameter describedDelete a bookmark by its ID. This action is irreversible.
list_bookmark_folders2 of 2 parameters describedList the bookmark folder hierarchy. Returns a tree structure of all folders.
get_bookmark_folder_contents2 of 2 parameters describedGet the contents of a bookmark folder (bookmarks and subfolders).
create_bookmark_folder2 of 2 parameters describedCreate a new bookmark folder.
update_bookmark_folder3 of 3 parameters describedUpdate a bookmark folder (rename or move to a different parent).
delete_bookmark_folder1 of 1 parameter describedDelete a bookmark folder and all its contents. This action is irreversible.
list_bookmark_tagsno parametersList all tags used across bookmarks.
rename_bookmark_tag2 of 2 parameters describedRename a bookmark tag. All bookmarks with the old tag will be updated.
delete_bookmark_tag1 of 1 parameter describedDelete a bookmark tag. The tag will be removed from all bookmarks.
list_pollsno parametersList all polls the current user can access (own, shared, or public). Returns id, title, type, owner, and status.
get_poll1 of 1 parameter describedGet full details of a poll by ID: configuration, owner, status, and current user state.
create_poll2 of 2 parameters describedCreate a new poll. Type "textPoll" for text options (e.g. lunch choices), "datePoll" for date/time options (e.g. meeting scheduling).
update_poll2 of 15 parameters describedUpdate a poll configuration. Only provided fields are changed. Set expire to 0 for no expiration, or a unix timestamp to auto-close on that date.
delete_poll1 of 1 parameter describedPermanently delete a poll. This cannot be undone.
close_poll1 of 1 parameter describedClose a poll immediately so no further votes are accepted.
reopen_poll1 of 1 parameter describedReopen a previously closed poll so voting can resume.
clone_poll1 of 1 parameter describedClone an existing poll, copying its configuration and options into a new poll.
list_poll_options1 of 1 parameter describedList all options for a poll, with vote tallies per option.
add_text_poll_option2 of 2 parameters describedAdd a text option to a textPoll (e.g. "Pizza", "Sushi"). Use add_date_poll_option for datePolls.
add_date_poll_option3 of 3 parameters describedAdd a date/time option to a datePoll. Provide startAt as ISO-8601 (e.g. "2026-05-12T14:00:00Z") and durationSeconds (e.g. 3600 for 1 hour).
delete_poll_option1 of 1 parameter describedDelete an option from a poll by option ID.
list_poll_votes1 of 1 parameter describedList all votes for a poll. Anonymous polls redact voters' identities.
vote_on_poll2 of 2 parameters describedCast or change your vote on a poll option. setTo: "yes" to vote yes, "no" to vote no, "maybe" for a tentative yes (only if allowed).
list_poll_comments1 of 1 parameter describedList all comments on a poll.
add_poll_comment2 of 2 parameters describedPost a comment on a poll (requires comments to be enabled).
delete_poll_comment1 of 1 parameter describedDelete one of your poll comments by comment ID.
list_poll_shares1 of 1 parameter describedList all shares (public link, user invitations, email invitations) for a poll.
add_poll_share4 of 4 parameters describedShare a poll. type="public" creates a public link (no extra fields). type="user" invites a Nextcloud user (requires userId). type="email" invites by email (requires userId=email address, displayName).
delete_poll_share1 of 1 parameter describedRevoke a poll share by its token (obtained from list_poll_shares or add_poll_share).
set_poll_subscription2 of 2 parameters describedSubscribe or unsubscribe the current user to poll notifications (new votes, comments). Use subscribe=true to subscribe, false to unsubscribe.
list_forms1 of 1 parameter describedList forms. type="owned" (default) returns forms the current user owns; "shared" returns forms shared with them; "partial" returns forms the user has an unfinished draft on.
get_form1 of 1 parameter describedGet full details for a form by ID, including questions, options, shares, and metadata.
create_formno parametersCreate a new empty form. Returns the new form ID. Use update_form to set title/description and create_form_question to add questions.
clone_form1 of 1 parameter describedClone an existing form (its questions, options, and settings) into a new form.
update_form2 of 10 parameters describedUpdate form properties. Only provided fields are changed. state: 0=active, 1=closed, 2=archived. expires=0 disables expiration.
transfer_form_owner2 of 2 parameters describedTransfer ownership of a form to another Nextcloud user. The new owner must have access to the Forms app.
delete_form1 of 1 parameter describedPermanently delete a form and all of its submissions. This cannot be undone.
list_form_questions1 of 1 parameter describedList all questions for a form, in display order.
create_form_question3 of 3 parameters describedAdd a question to a form. For choice questions use type "multiple" (checkbox), "multiple_unique" (radio), or "dropdown" — then call create_form_options.
update_form_question4 of 7 parameters describedUpdate question properties (text, requirement, type, etc.). Only provided fields are changed.
reorder_form_questions2 of 2 parameters describedReorder all questions in a form. Pass the full list of question IDs in the desired order.
delete_form_question2 of 2 parameters describedDelete a question from a form.
create_form_options3 of 3 parameters describedAdd one or more options to a choice question (multiple/multiple_unique/dropdown). Pass an array of option texts.
update_form_option3 of 5 parameters describedUpdate a choice option's text (and optionally its order).
reorder_form_options3 of 3 parameters describedReorder all options for a choice question. Pass the full list of option IDs in the desired order.
delete_form_option3 of 3 parameters describedDelete an option from a choice question.
create_form_share4 of 4 parameters describedShare a form. type="user" shares with a Nextcloud user (shareWith=userId), "group" with a group (shareWith=groupId), "link" creates a public link (shareWith is the generated hash, omit it at creation).
update_form_share3 of 3 parameters describedUpdate the permissions on an existing form share.
delete_form_share2 of 2 parameters describedRevoke a form share.
list_form_submissions4 of 4 parameters describedList submissions for a form. Supports free-text search (query) and pagination (limit/offset). Only form owners/admins see all submissions.
get_form_submission2 of 2 parameters describedGet a single submission with all of its answers.
create_form_submission3 of 3 parameters describedSubmit answers to a form. `answers` is an object keyed by question ID; values are always arrays. For text questions: ["My answer"]. For choice questions: [optionId1, optionId2] (numeric IDs). Public links require `shareHash`.
delete_form_submission2 of 2 parameters describedDelete a single submission by ID.
delete_all_form_submissions1 of 1 parameter describedDelete every submission for a form. The form itself is kept. This cannot be undone.
export_form_submissions3 of 3 parameters describedExport a form's submissions as a spreadsheet into the user's Nextcloud storage. Returns the destination path. Use read_file / get_file_info afterwards to work with the export.
get_text_workspace1 of 1 parameter describedGet metadata of the Text workspace file (Readme.md) for a folder. Returns the file's id, name, mimetype and path, or reports that no workspace exists yet.
read_text_workspace1 of 1 parameter describedRead the content of a folder's Text workspace file (Readme.md). Returns markdown text, or a 'no workspace' message if none exists.
write_text_workspace2 of 2 parameters describedCreate or overwrite a folder's Text workspace file. If a workspace already exists, its existing filename is reused; otherwise Readme.md is created at the folder root.
delete_text_workspace1 of 1 parameter describedDelete the Text workspace file (Readme.md) for a folder. The folder itself is kept. No-op if the folder has no workspace.
get_text_workspace_edit_url1 of 1 parameter describedGet a one-shot direct-edit URL for a folder's Text workspace. Opens the live collaborative editor in a browser. The Readme.md is created automatically if it does not exist yet. Hand the URL to a human collaborator — the MCP server does not participate in the editing session.
list_text_tasksno parametersList AI task types available in Nextcloud's TaskProcessing framework (summarize, headline, image-to-text, text-to-image, …). Shows which task types have at least one provider configured.
process_text3 of 3 parameters describedSubmit 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).
get_task_result1 of 1 parameter describedGet the status and result of a Nextcloud AI task previously created by process_text or generate_image. Status: 1=scheduled, 2=running, 3=successful, 4=failed.
generate_image2 of 2 parameters describedGenerate an image from a text prompt using Nextcloud's text-to-image AI provider (e.g. Stable Diffusion via LocalAI). Returns the task ID; use get_task_result to check completion.
translate_text3 of 3 parameters describedTranslate text between languages using Nextcloud's configured translation provider. If called without text, returns available language pairs.
get_user_status1 of 1 parameter describedGet the current user's presence status (online, away, DND, invisible, custom message)
set_user_status1 of 1 parameter describedSet the current user's status type (online, away, dnd, invisible, offline)
set_user_status_message3 of 3 parameters describedSet a custom status message with optional emoji icon and auto-clear time
clear_user_status_messageno parametersClear the current user's custom status message
list_user_statuses2 of 2 parameters describedList all users' statuses for team presence visibility
list_notificationsno parametersList all notifications for the current user
get_notification1 of 1 parameter describedGet details of a specific notification by ID
mark_notification_read1 of 1 parameter describedMark a notification as read (deletes it)
delete_all_notificationsno parametersDelete all notifications for the current user
list_activity4 of 4 parameters describedList recent entries from the Nextcloud activity feed (file changes, shares, comments, calendar/contact edits, etc.) for the current user.
get_object_activity3 of 3 parameters describedList the activity history for a single object, e.g. one file. Use object_type 'files' with a file ID to see what happened to that file.
list_announcements1 of 1 parameter describedList announcements from the Nextcloud Announcement Center (org-wide notices such as maintenance windows, events, or news). Returns newest first.
create_announcement10 of 10 parameters describedCreate a new announcement in the Announcement Center. This is visible to all or selected groups and can trigger notifications/emails — use deliberately. Requires the configured Nextcloud user to be an admin.
delete_announcement1 of 1 parameter describedDelete an announcement by its ID. Requires the configured Nextcloud user to be an admin.
get_registration_settingsno parametersRead the Nextcloud Registration app settings (self-service signup configuration), such as allowed email domains, whether admin approval is required, and the default group for new users. Requires the configured Nextcloud user to be an admin.
update_registration_settings1 of 1 parameter describedUpdate one or more Nextcloud Registration app settings. Boolean settings use the strings 'yes'/'no'; allowed_domains takes a JSON array string (e.g. '["example.com"]'). Requires the configured Nextcloud user to be an admin.
reset_registration_setting1 of 1 parameter describedReset a Nextcloud Registration app setting to its default by deleting the stored value. Requires the configured Nextcloud user to be an admin.
get_terms_of_serviceno parametersRead the Nextcloud Terms of Service admin configuration: all published terms (by country/language), the enforcement settings (tos_for_users, tos_on_public_shares), and the valid country and language codes that can be used when setting terms. Requires the configured Nextcloud user to be an admin.
set_terms_of_service3 of 3 parameters describedCreate or update the terms of service for a given country/language pair. If terms already exist for that pair they are replaced, otherwise new terms are created. Use get_terms_of_service to discover valid country/language codes; an invalid code returns an error (HTTP 417). Requires the configured Nextcloud user to be an admin.
delete_terms_of_service1 of 1 parameter describedDelete a single terms of service entry by its id (see get_terms_of_service). Requires the configured Nextcloud user to be an admin.
reset_terms_signaturesno parametersReset 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.
update_terms_settings2 of 2 parameters describedUpdate the Terms of Service enforcement settings: whether logged-in users must accept the terms (tos_for_users) and whether the terms apply to public shares (tos_on_public_shares). Requires the configured Nextcloud user to be an admin.
list_recommendationsno parametersList files Nextcloud recommends for the configured user (e.g. recently or frequently accessed, recently shared, or files in active folders), including the reason each file is recommended. Respects the user's recommendations setting.
generate_social_share_links3 of 3 parameters describedGenerate social-network share URLs (email, X/Twitter, Facebook, Telegram, WhatsApp, Bluesky, Diaspora) for an existing Nextcloud public-link share. Only networks whose socialsharing_<network> app is enabled are returned. Provide either share_id or path.
Tested in a sandbox with an empty environment: no API keys, a throwaway folder, nothing from a real account. A passing test shows the server runs and responds. It is not a security audit.