Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
HOSTNoBind host (HTTP transports)0.0.0.0
PORTNoBind port (HTTP transports)8000
USERTOOLNoEnable user toolTrue
FILESTOOLNoEnable files toolTrue
TRANSPORTNoTransport method: stdio, streamable-http, or ssestdio
SHARINGTOOLNoEnable sharing toolTrue
CALENDARTOOLNoEnable calendar toolTrue
CONTACTSTOOLNoEnable contacts toolTrue
MCP_TOOL_MODENoTool surface: condensed, verbose, or bothcondensed
NEXTCLOUD_URLYesBase URL of the Nextcloud instancehttps://nextcloud.example.com
NEXTCLOUD_HOSTEDNoWhether the instance is hosted (managed)false
NEXTCLOUD_SECRETNoOAuth/SSO client secret
NEXTCLOUD_CLIENTIDNoOAuth/SSO client idsso
NEXTCLOUD_PASSWORDNoPassword / app password (basic auth)
NEXTCLOUD_USERNAMENoUsername (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

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": true
}
resources
{
  "subscribe": false,
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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; color is a hex RGB value without #.

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; duedate is ISO 8601.

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 token.

POST /ocs/v2.php/apps/spreed/api/v4/room

group is private (members only, no link); public can be joined by link; one_to_one needs invite (a user id).

nextcloud_create_documentA

Create one new document at path; the extension picks the type (.docx, .xlsx, .pptx, .odg, .md).

POST /ocs/v2.php/apps/files/api/v1/templates/create

template_path is a template filename from list_document_templates; omitted, the document starts empty. Everyone with access to the file edits it together in real time.

nextcloud_create_eventB

Create one event. Attendees get a draft invitation unless send_invitations.

PUT /remote.php/dav/calendars/{user}/{calendar}/{uid}.ics

start/end are ISO 8601 (a naive time is UTC); end defaults to one hour (one day when all_day) after start. With send_invitations false the attendees are marked SCHEDULE-AGENT=CLIENT, so the server sends no invitation email.

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 url).

POST /ocs/v2.php/apps/files_sharing/api/v1/shares

share_type user/group/talk needs share_with (user id, group id or conversation token). permissions is the OCS bitmask: 1 read, 2 update, 4 create, 8 delete, 16 share (31 all). expire_date is YYYY-MM-DD. send_mail false (the default) creates the share without the server mailing the recipient.

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

priority follows iCalendar: 1 highest, 9 lowest, 0 undefined.

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 (object_type="files" with a file id) when given.

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 order.

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 url for the connected account (Office for office files, Text for markdown).

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

mime_prefix narrows to a content type family, for example image/ or video/. Returns paths relative to the account root.

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 encoding="utf-8", or binary content (an image, a video, an office document) base64-encoded with encoding="base64". Uploading over an existing file keeps the old content as a version.

Prompts

Interactive templates invoked by user choice

NameDescription
connector-statusAsk for this connector server's current operational status.
asset_publisherMarketing 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_stewardNextcloud File Steward: Keep the file tree organized and safe: find, file, version and recover documents, and manage access.
office_coordinatorOffice 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.
operatorNextcloud Operator: Run the business's collaboration workspace end to end: files, sharing, calendar, tasks, contacts, Talk, Deck, notes, office documents, activity and administration.
project_coordinatorProject Coordinator: Coordinate projects: run Deck boards, track tasks, start collaborative documents for the team, keep notes, and watch the activity stream for changes.
workspace_adminWorkspace 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

NameDescription
_connector_status_resourceNative resource exposing this server's static status payload.
ontology://nextcloud-mcp/nextcloud.ttl
ontology://nextcloud-mcp/contracts.ttl
connector-resourcesData sources, ontology mappings and resources of this connector.
nextcloud-agent-operations/SKILL.mdOperate 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/_manifestFile listing for nextcloud-agent-operations
nextcloud-ingest/SKILL.mdFederate 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/_manifestFile listing for nextcloud-ingest
nextcloud-calendar/SKILL.mdRun 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/_manifestFile listing for nextcloud-calendar
nextcloud-deck/SKILL.mdRun 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/_manifestFile listing for nextcloud-deck
nextcloud-contacts/SKILL.mdManage 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/_manifestFile listing for nextcloud-contacts
nextcloud-admin/SKILL.mdAdminister 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/_manifestFile listing for nextcloud-admin
nextcloud-publish-asset/SKILL.mdPublish 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/_manifestFile listing for nextcloud-publish-asset
nextcloud-files/SKILL.mdBrowse 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/_manifestFile listing for nextcloud-files
nextcloud-activity/SKILL.mdRead 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/_manifestFile listing for nextcloud-activity
nextcloud-tasks/SKILL.mdManage 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/_manifestFile listing for nextcloud-tasks
nextcloud-shares/SKILL.mdGrant 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/_manifestFile listing for nextcloud-shares
nextcloud-office/SKILL.mdCreate 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/_manifestFile listing for nextcloud-office
nextcloud-notes/SKILL.mdKeep 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/_manifestFile listing for nextcloud-notes
nextcloud-talk/SKILL.mdUse 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/_manifestFile listing for nextcloud-talk
nextcloud-agent-development/SKILL.mdDevelop 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/_manifestFile listing for nextcloud-agent-development

TDQS

B3/5.0

Scored across 89 tools

Disambiguation4/5

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.

Naming Consistency5/5

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.

Tool Count1/5

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.

Completeness4/5

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.

Maintenance

ActivityActive
ResponsivenessNo recent community issues