nextcloud-agent
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HOST | No | Bind host (HTTP transports) | 0.0.0.0 |
| PORT | No | Bind port (HTTP transports) | 8000 |
| USERTOOL | No | Enable user tool | True |
| FILESTOOL | No | Enable files tool | True |
| TRANSPORT | No | Transport method: stdio, streamable-http, or sse | stdio |
| SHARINGTOOL | No | Enable sharing tool | True |
| CALENDARTOOL | No | Enable calendar tool | True |
| CONTACTSTOOL | No | Enable contacts tool | True |
| MCP_TOOL_MODE | No | Tool surface: condensed, verbose, or both | condensed |
| NEXTCLOUD_URL | Yes | Base URL of the Nextcloud instance | https://nextcloud.example.com |
| NEXTCLOUD_HOSTED | No | Whether the instance is hosted (managed) | false |
| NEXTCLOUD_SECRET | No | OAuth/SSO client secret | |
| NEXTCLOUD_CLIENTID | No | OAuth/SSO client id | sso |
| NEXTCLOUD_PASSWORD | No | Password / app password (basic auth) | |
| NEXTCLOUD_USERNAME | No | Username (basic auth) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Nextcloud MCP server: one typed tool per operation for files, versions, search, sharing, calendar, tasks, contacts, Talk, Deck, Notes, office documents, activity, notifications and user, group and app administration.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| nextcloud_add_participantB | Add a user, group, email guest or team to one conversation. POST /ocs/v2.php/apps/spreed/api/v4/room/{token}/participants |
| nextcloud_add_user_to_groupC | Add one account to a group. POST /ocs/v2.php/cloud/users/{user_id}/groups |
| nextcloud_assign_card_userC | Assign one user to a card. PUT /index.php/apps/deck/api/v1.0/boards/{board_id}/stacks/{stack_id}/cards/{card_id}/assignUser |
| nextcloud_copy_itemC | Copy one file or folder. COPY /remote.php/dav/files/{user}/{source_path} |
| nextcloud_create_boardB | Create one board; POST /index.php/apps/deck/api/v1.0/boards |
| nextcloud_create_calendarB | Create one calendar that holds events and, by default, tasks. MKCALENDAR /remote.php/dav/calendars/{user}/{slug} |
| nextcloud_create_cardB | Create one card in a stack; POST /index.php/apps/deck/api/v1.0/boards/{board_id}/stacks/{stack_id}/cards |
| nextcloud_create_contactC | Create one contact in an address book. PUT /remote.php/dav/addressbooks/users/{user}/{book}/{uid}.vcf |
| nextcloud_create_conversationA | Create one conversation and return it with its POST /ocs/v2.php/apps/spreed/api/v4/room
|
| nextcloud_create_documentA | Create one new document at POST /ocs/v2.php/apps/files/api/v1/templates/create
|
| nextcloud_create_eventB | Create one event. Attendees get a draft invitation unless PUT /remote.php/dav/calendars/{user}/{calendar}/{uid}.ics
|
| nextcloud_create_folderB | Create one folder. MKCOL /remote.php/dav/files/{user}/{path} |
| nextcloud_create_groupC | Create one group. POST /ocs/v2.php/cloud/groups |
| nextcloud_create_noteC | Create one note. POST /index.php/apps/notes/api/v1/notes |
| nextcloud_create_shareA | Share one file or folder and return the share (a public link carries its POST /ocs/v2.php/apps/files_sharing/api/v1/shares
|
| nextcloud_create_stackC | Create one stack (column) on a board. POST /index.php/apps/deck/api/v1.0/boards/{board_id}/stacks |
| nextcloud_create_taskA | Create one task (VTODO) in a task-capable calendar (the Tasks app shows it). PUT /remote.php/dav/calendars/{user}/{calendar}/{uid}.ics
|
| nextcloud_create_userB | Create one account. Give a password, or an email for a set-password invite. POST /ocs/v2.php/cloud/users |
| nextcloud_delete_boardB | Delete one board (Deck keeps it restorable for a while). DELETE /index.php/apps/deck/api/v1.0/boards/{board_id} |
| nextcloud_delete_calendarA | Delete one calendar and everything in it (it moves to the calendar trash). DELETE /remote.php/dav/calendars/{user}/{slug} |
| nextcloud_delete_calendar_objectC | Delete one event or task. DELETE /remote.php/dav/calendars/{user}/{calendar}/{object}.ics |
| nextcloud_delete_cardC | Delete one card. DELETE /index.php/apps/deck/api/v1.0/boards/{board_id}/stacks/{stack_id}/cards/{card_id} |
| nextcloud_delete_contactC | Delete one contact. DELETE /remote.php/dav/addressbooks/users/{user}/{book}/{contact}.vcf |
| nextcloud_delete_conversationA | Delete one conversation for everyone (moderators only). DELETE /ocs/v2.php/apps/spreed/api/v4/room/{token} |
| nextcloud_delete_groupA | Delete one group (its members keep their accounts). DELETE /ocs/v2.php/cloud/groups/{group_id} |
| nextcloud_delete_itemA | Delete one file or folder (it moves to the trash bin). DELETE /remote.php/dav/files/{user}/{path} |
| nextcloud_delete_messageC | Delete one chat message. DELETE /ocs/v2.php/apps/spreed/api/v1/chat/{token}/{message_id} |
| nextcloud_delete_noteB | Delete one note. DELETE /index.php/apps/notes/api/v1/notes/{note_id} |
| nextcloud_delete_shareC | Revoke one share. DELETE /ocs/v2.php/apps/files_sharing/api/v1/shares/{share_id} |
| nextcloud_delete_stackB | Delete one stack and its cards. DELETE /index.php/apps/deck/api/v1.0/boards/{board_id}/stacks/{stack_id} |
| nextcloud_delete_userB | Delete one account and its files. DELETE /ocs/v2.php/cloud/users/{user_id} |
| nextcloud_disable_appC | Disable one app. DELETE /ocs/v2.php/cloud/apps/{app_id} |
| nextcloud_disable_userA | Disable one account (it can no longer log in; data is kept). PUT /ocs/v2.php/cloud/users/{user_id}/disable |
| nextcloud_dismiss_notificationC | Dismiss one notification. DELETE /ocs/v2.php/apps/notifications/api/v2/notifications/{notification_id} |
| nextcloud_enable_appC | Enable one installed app. POST /ocs/v2.php/cloud/apps/{app_id} |
| nextcloud_enable_userA | Enable one disabled account. PUT /ocs/v2.php/cloud/users/{user_id}/enable |
| nextcloud_get_appA | Read one installed app's metadata (name, version, dependencies). GET /ocs/v2.php/cloud/apps/{app_id} |
| nextcloud_get_boardB | Read one board with its labels and members. GET /index.php/apps/deck/api/v1.0/boards/{board_id} |
| nextcloud_get_calendar_objectA | Read one event or task: its parsed fields, etag and raw iCalendar text. GET /remote.php/dav/calendars/{user}/{calendar}/{object}.ics |
| nextcloud_get_cardB | Read one card. GET /index.php/apps/deck/api/v1.0/boards/{board_id}/stacks/{stack_id}/cards/{card_id} |
| nextcloud_get_contactA | Read one contact: parsed fields, etag and the raw vCard. GET /remote.php/dav/addressbooks/users/{user}/{book}/{contact}.vcf |
| nextcloud_get_conversationA | Read one conversation by its token. GET /ocs/v2.php/apps/spreed/api/v4/room/{token} |
| nextcloud_get_noteB | Read one note with its content. GET /index.php/apps/notes/api/v1/notes/{note_id} |
| nextcloud_get_propertiesA | Read the properties of one file or folder (size, type, etag, file id). PROPFIND /remote.php/dav/files/{user}/{path} |
| nextcloud_get_shareB | Read one share by id. GET /ocs/v2.php/apps/files_sharing/api/v1/shares/{share_id} |
| nextcloud_get_userB | Read one account's details. GET /ocs/v2.php/cloud/users/{user_id} |
| nextcloud_get_user_infoA | Read the connected account: id, display name, email, quota, groups. GET /ocs/v2.php/cloud/user |
| nextcloud_get_user_quotaB | Read the storage quota of the connected account. PROPFIND /remote.php/dav/files/{user} |
| nextcloud_list_activitiesB | Read the activity stream, newest first; narrow to one object
( GET /ocs/v2.php/apps/activity/api/v2/activity |
| nextcloud_list_address_booksA | List the account's address books. PROPFIND /remote.php/dav/addressbooks/users/{user} |
| nextcloud_list_appsA | List installed app ids that are enabled, disabled, or all of them. GET /ocs/v2.php/cloud/apps |
| nextcloud_list_boardsA | List the Deck boards the account can see. GET /index.php/apps/deck/api/v1.0/boards |
| nextcloud_list_calendarsB | List the account's calendars and the components (VEVENT, VTODO) each holds. PROPFIND /remote.php/dav/calendars/{user} |
| nextcloud_list_contactsB | List the contacts of one address book with name, emails, phones and organization. REPORT /remote.php/dav/addressbooks/users/{user}/{book} |
| nextcloud_list_conversationsA | List the conversations the account takes part in. GET /ocs/v2.php/apps/spreed/api/v4/room |
| nextcloud_list_document_templatesA | List the document types the server can create (document, spreadsheet, presentation, diagram, markdown) with their extensions and templates. GET /ocs/v2.php/apps/files/api/v1/templates |
| nextcloud_list_eventsB | List the events of one calendar, optionally within an ISO time range. REPORT /remote.php/dav/calendars/{user}/{calendar} |
| nextcloud_list_filesA | List the files and folders in one folder (PROPFIND, depth 1). PROPFIND /remote.php/dav/files/{user}/{path} |
| nextcloud_list_group_membersC | List the account ids in one group. GET /ocs/v2.php/cloud/groups/{group_id}/users |
| nextcloud_list_groupsC | List group ids, optionally matching a search string. GET /ocs/v2.php/cloud/groups |
| nextcloud_list_messagesB | Read the chat history of one conversation, newest first. GET /ocs/v2.php/apps/spreed/api/v1/chat/{token} |
| nextcloud_list_notesB | List the account's notes, optionally of one category. GET /index.php/apps/notes/api/v1/notes |
| nextcloud_list_notificationsB | List the account's current notifications. GET /ocs/v2.php/apps/notifications/api/v2/notifications |
| nextcloud_list_participantsB | List the participants of one conversation. GET /ocs/v2.php/apps/spreed/api/v4/room/{token}/participants |
| nextcloud_list_sharesB | List shares: all of the account's shares, the shares on one path, or the shares other people gave the account. GET /ocs/v2.php/apps/files_sharing/api/v1/shares |
| nextcloud_list_stacksB | List the stacks (columns) of one board, each with its cards. GET /index.php/apps/deck/api/v1.0/boards/{board_id}/stacks |
| nextcloud_list_tasksC | List the tasks (VTODO) of one task-capable calendar. REPORT /remote.php/dav/calendars/{user}/{calendar} |
| nextcloud_list_trashA | List the items in the trash bin of the connected account. PROPFIND /remote.php/dav/trashbin/{user}/trash |
| nextcloud_list_usersB | List account ids, optionally matching a search string. GET /ocs/v2.php/cloud/users |
| nextcloud_list_versionsB | List the stored versions of one file, newest first. PROPFIND /remote.php/dav/versions/{user}/versions/{fileid} |
| nextcloud_move_cardB | Move one card to a stack (column) of the board, at position PUT /index.php/apps/deck/api/v1.0/boards/{board_id}/stacks/{target_stack_id}/cards/{card_id}/reorder |
| nextcloud_move_itemC | Move or rename one file or folder. MOVE /remote.php/dav/files/{user}/{source_path} |
| nextcloud_open_documentA | Open one document for editing and return a one-time editor POST /ocs/v2.php/apps/richdocuments/api/v1/document |
| nextcloud_read_fileA | Download one file; the bytes come back base64-encoded. GET /remote.php/dav/files/{user}/{path} |
| nextcloud_remove_participantB | Remove one attendee (by attendee id from list_participants) from a conversation. DELETE /ocs/v2.php/apps/spreed/api/v4/room/{token}/attendees |
| nextcloud_remove_user_from_groupC | Remove one account from a group. DELETE /ocs/v2.php/cloud/users/{user_id}/groups |
| nextcloud_rename_conversationC | Rename one conversation. PUT /ocs/v2.php/apps/spreed/api/v4/room/{token} |
| nextcloud_restore_trash_itemA | Restore one trash-bin item to its original location. MOVE /remote.php/dav/trashbin/{user}/trash/{trash_id} |
| nextcloud_restore_versionB | Restore one stored version of a file; the current content becomes a version. MOVE /remote.php/dav/versions/{user}/versions/{fileid}/{version_id} |
| nextcloud_search_filesB | Search files by name (case-insensitive substring) under one folder. SEARCH /remote.php/dav
|
| nextcloud_send_messageC | Post one chat message to a conversation. POST /ocs/v2.php/apps/spreed/api/v1/chat/{token} |
| nextcloud_update_cardC | Change one card's title, description or due date. PUT /index.php/apps/deck/api/v1.0/boards/{board_id}/stacks/{stack_id}/cards/{card_id} |
| nextcloud_update_contactB | Change one contact; omitted fields keep their value. Guarded by the etag. PUT /remote.php/dav/addressbooks/users/{user}/{book}/{contact}.vcf |
| nextcloud_update_eventB | Change one event's fields; the write is guarded by the event's etag. PUT /remote.php/dav/calendars/{user}/{calendar}/{object}.ics |
| nextcloud_update_noteB | Change one note's title, content, category or favorite flag. PUT /index.php/apps/notes/api/v1/notes/{note_id} |
| nextcloud_update_shareC | Change one share's permissions, password, expiry, label or note. PUT /ocs/v2.php/apps/files_sharing/api/v1/shares/{share_id} |
| nextcloud_update_taskB | Change one task, or mark it complete or open again; guarded by its etag. PUT /remote.php/dav/calendars/{user}/{calendar}/{object}.ics |
| nextcloud_update_userC | Change one field of an account. PUT /ocs/v2.php/cloud/users/{user_id} |
| nextcloud_write_fileA | Upload one file, creating missing parent folders. PUT /remote.php/dav/files/{user}/{path} Pass text with |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| connector-status | Ask for this connector server's current operational status. |
| asset_publisher | Marketing Asset Publisher: Take finished creative-suite assets (photos, videos, marketing graphics) and publish them to the team folder in Nextcloud, share them with the right team, and produce expiring public links when asked. |
| file_steward | Nextcloud File Steward: Keep the file tree organized and safe: find, file, version and recover documents, and manage access. |
| office_coordinator | Office Coordinator: Keep the office running: schedule meetings with draft invitations, keep to-do lists, maintain customer and supplier contacts, keep meeting notes, and keep the team informed in Talk. |
| operator | Nextcloud Operator: Run the business's collaboration workspace end to end: files, sharing, calendar, tasks, contacts, Talk, Deck, notes, office documents, activity and administration. |
| project_coordinator | Project Coordinator: Coordinate projects: run Deck boards, track tasks, start collaborative documents for the team, keep notes, and watch the activity stream for changes. |
| workspace_admin | Workspace Administrator: Administer the workspace: onboard and offboard people, organize groups, audit shares and keep the business app set enabled. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| _connector_status_resource | Native resource exposing this server's static status payload. |
| ontology://nextcloud-mcp/nextcloud.ttl | |
| ontology://nextcloud-mcp/contracts.ttl | |
| connector-resources | Data sources, ontology mappings and resources of this connector. |
| nextcloud-agent-operations/SKILL.md | Operate nextcloud-agent through its governed MCP and Arbora capabilities, covering files, sharing, calendar, tasks, contacts, Talk, Deck, notes, office documents, activity, administration, asset publishing and ingestion. Use when a request requires this provider's read, change, automation, ingestion, troubleshooting, or evidence workflows. |
| nextcloud-agent-operations/_manifest | File listing for nextcloud-agent-operations |
| nextcloud-ingest/SKILL.md | Federate Nextcloud records into the knowledge graph through the connector's declared sources: files and folders, shares, notes, Deck boards, Talk conversations, calendars and address books. Use when the agent must make Nextcloud data queryable in the graph or refresh it. Do NOT use to download or move a file (nextcloud-files) or to change shares (nextcloud-shares). |
| nextcloud-ingest/_manifest | File listing for nextcloud-ingest |
| nextcloud-calendar/SKILL.md | Run Nextcloud calendars over CalDAV: list calendars, create or delete a calendar, list events in a time range, read, create, update and delete events, with attendee invitations kept as drafts unless sending is explicitly requested. Use when the agent must schedule, reschedule or cancel a meeting or check availability. Do NOT use for to-dos (nextcloud-tasks) or contacts (nextcloud-contacts). |
| nextcloud-calendar/_manifest | File listing for nextcloud-calendar |
| nextcloud-deck/SKILL.md | Run Nextcloud Deck kanban boards: list, read, create and delete boards; list, create and delete stacks; create, read, update, move, assign and delete cards. Use when the agent must track work items through stages (to do, doing, done). Do NOT use for personal to-dos (nextcloud-tasks). |
| nextcloud-deck/_manifest | File listing for nextcloud-deck |
| nextcloud-contacts/SKILL.md | Manage Nextcloud contacts over CardDAV: list address books, list contacts with names, emails, phones and organization, read, create, update and delete a contact. Use when the agent must look up or maintain customer, supplier or team contact details. Do NOT use for account administration (nextcloud-admin). |
| nextcloud-contacts/_manifest | File listing for nextcloud-contacts |
| nextcloud-admin/SKILL.md | Administer the Nextcloud workspace: read the connected account; list, read, create, update, disable, enable and delete accounts; list, create and delete groups and manage membership; list installed apps and enable or disable them. Use when the agent must onboard or offboard a team member, organize teams into groups, or check which apps are on. Requires an admin account. Do NOT use for contact cards (nextcloud-contacts). |
| nextcloud-admin/_manifest | File listing for nextcloud-admin |
| nextcloud-publish-asset/SKILL.md | Publish a produced business asset (a photo, video, marketing graphic or document from the creative suite) to the team folder in Nextcloud and share it: copy it from the production archive into Team/<campaign>, grant the team group access once, and create an expiring public link for external use. Use when an asset is ready for the team or for a customer, partner or social post. Do NOT use to produce the asset (the creative suite skills), for machine delivery or a website/CDN URL (the object storage skills), or to post to social channels. |
| nextcloud-publish-asset/_manifest | File listing for nextcloud-publish-asset |
| nextcloud-files/SKILL.md | Browse and manage Nextcloud files: list, download, upload text or binary (base64), create folders, move, copy, delete, read properties and quota, list and restore versions, search by name and type, and restore from the trash bin. Use when the agent must find, fetch, store or reorganize files, or roll a file back. Do NOT use for sharing (nextcloud-shares), publishing a produced asset (nextcloud-publish-asset) or graph ingestion (nextcloud-ingest). |
| nextcloud-files/_manifest | File listing for nextcloud-files |
| nextcloud-activity/SKILL.md | Read the Nextcloud activity stream (who created, changed, shared or deleted what) for the whole account or one file, and read and dismiss notifications. Use when the agent must audit recent changes, confirm an action landed, or clear handled notifications. Do NOT use to change files or shares. |
| nextcloud-activity/_manifest | File listing for nextcloud-activity |
| nextcloud-tasks/SKILL.md | Manage to-dos (VTODO) in Nextcloud task-capable calendars, which the Tasks app shows: list open or all tasks, create a task with due date and priority, update it, mark it complete or reopen it, delete it. Use when the agent must track personal or team to-dos. Do NOT use for kanban work items (nextcloud-deck) or meetings (nextcloud-calendar). |
| nextcloud-tasks/_manifest | File listing for nextcloud-tasks |
| nextcloud-shares/SKILL.md | Grant and audit access to Nextcloud files and folders: internal shares to a user, group or Talk conversation, and public links with password, expiry, label and note. Use when the agent must give someone access, produce a public link, audit who can see a path, or revoke access. Do NOT use to move or upload files (nextcloud-files). |
| nextcloud-shares/_manifest | File listing for nextcloud-shares |
| nextcloud-office/SKILL.md | Create office documents (docx, xlsx, pptx, odg) and collaborative markdown in Nextcloud and open browser editing sessions where everyone with access edits together in real time (Nextcloud Office on the built-in document server; Text for markdown). Use when the agent must start a document for people to work on. Do NOT use to upload a finished file (nextcloud-files). |
| nextcloud-office/_manifest | File listing for nextcloud-office |
| nextcloud-notes/SKILL.md | Keep Nextcloud Notes: list notes by category, read, create, update and delete a note (markdown, stored as files in the Notes folder). Use when the agent must keep meeting notes, checklists or reference text the team can open in Notes. Do NOT use for collaborative office documents (nextcloud-office). |
| nextcloud-notes/_manifest | File listing for nextcloud-notes |
| nextcloud-talk/SKILL.md | Use Nextcloud Talk: list, read, create, rename and delete conversations; list, add and remove participants; read chat history; post and delete messages. Use when the agent must message the team, keep a project channel, or read what was said. Do NOT use to email people or post to public social channels. |
| nextcloud-talk/_manifest | File listing for nextcloud-talk |
| nextcloud-agent-development/SKILL.md | Develop and verify nextcloud-agent as a connector-owned package while preserving its SDK Connector wiring, action-routed MCP tools, Nextcloud authentication and TLS boundary, packaged content, and source-backed spec-delivery publication. |
| nextcloud-agent-development/_manifest | File listing for nextcloud-agent-development |
TDQS
Scored across 89 tools
Most tools map cleanly to a distinct resource and action across files, notes, Deck, Calendar, Contacts, Talk, users, groups, apps, shares, and notifications. A few boundaries are softer, such as generic calendar-object tools versus event/task-specific tools, and get_user_info overlapping with get_user_quota, but descriptions generally make the intended use clear.
Tool names consistently use the nextcloud_ prefix followed by a snake_case verb_noun pattern. Variations like get_user_info or add_user_to_group still fit the same naming convention and remain predictable.
With 89 tools, the surface is far beyond a well-scoped toolset and imposes heavy selection and context overhead on an agent. Even for a broad Nextcloud integration, this is an extreme tool count that should be consolidated into fewer higher-level operations.
Coverage is broad and includes core workflows for files, sharing, versions, trash, contacts, calendars, Deck cards, Talk, notes, users, groups, apps, and notifications. Minor gaps remain, such as no update operations for boards, stacks, calendars, groups, or address books, but most common agent tasks are supported.