Nextcloud MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NEXTCLOUD_URL | No | Server URL, e.g. https://cloud.example.com. Optional; overrides the saved value (useful in Docker/CI). | |
| NEXTCLOUD_USER | No | Login name. Optional; overrides the saved value (useful in Docker/CI). | |
| NEXTCLOUD_USER_ID | No | Internal user ID, if it differs from the login name (otherwise call login once). Optional; overrides the saved value. | |
| NEXTCLOUD_APP_PASSWORD | No | App password. Optional; overrides the saved value (useful in Docker/CI). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| loginA | Sign in to Nextcloud with Login Flow v2: opens the server's login page in the default browser, the user signs in (SSO works), and an app password is issued and saved. Waits up to 2 minutes, then keeps waiting in the background and returns the login URL. Call this when other tools report that the user is not logged in. Without a browser, pass |
| disk_infoA | Storage info of the Nextcloud account: used and available quota, server and user |
| list_filesA | List files and folders at a path. Paths are relative to the user's files root, e.g. '/' or '/Projects'. A Files app link (…/apps/files/files/123?dir=/folder) works too. |
| get_file_infoB | Detailed metadata of a file or folder: size, dates, type, file ID, permissions, web link |
| search_filesA | Server-side search by name (case-insensitive substring) in a folder tree, newest first. Optional MIME filter. Without |
| recent_filesB | Files modified recently, newest first (server-side search by modification date) |
| create_folderB | Create a folder (missing parent folders are created too) |
| deleteA | Delete files or folders (they go to the trash bin of their owner; restore with restore_from_trash) |
| copyB | Copy a file or folder. A destination ending with '/' means 'into this folder, same name'. |
| moveB | Move or rename a file or folder. A destination ending with '/' means 'into this folder, same name'. |
| upload_fileA | Upload a local file. Big files are uploaded in chunks. A destination ending with '/' keeps the local name. |
| upload_folderA | Upload a whole local folder recursively in one call (parallel). The folder is created inside |
| downloadB | Download a file or a whole folder (recursively, parallel) to this machine. |
| read_fileB | Read a text file (txt, md, json, csv, svg, …) and return its contents (first 200 KB) |
| set_favoriteB | Mark or unmark a file/folder as favorite |
| create_shareA | Share a file or folder: a public link (default), or with a user, group or email address. Returns the link for public shares. |
| list_sharesA | List shares made by the user: all, or of one path; with |
| list_shared_with_meA | List files and folders other users shared with the current user (paths where they appear) |
| update_shareB | Change a share: permissions, password, expiry date, label or note (ID from list_shares) |
| delete_shareA | Remove a share or public link (ID from list_shares); the file itself stays |
| list_trashA | List items in the trash bin, newest first |
| restore_from_trashA | Restore an item from the trash bin to its original location (id from list_trash) |
| clear_trashA | Permanently delete one item from the trash bin, or empty the whole trash bin. Irreversible. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 23 tools
Most tools target clearly distinct resources and actions: file reads, metadata, search, upload/download, folder creation, move/copy/delete, sharing, and trash operations. A few pairs could be confused at first glance (read_file vs. download, get_file_info vs. disk_info), but descriptions clarify the boundaries well.
The set mostly follows verb_noun patterns such as list_files, get_file_info, create_share, update_share, and restore_from_trash. There are some deviations—single-verb names like delete, copy, move, download, login—and noun-first names like disk_info and recent_files, but the naming remains readable and predictable.
23 tools is on the high side, but the server covers a broad domain: file browsing, reading, upload/download, folder operations, sharing, favorites, trash, login, and storage info. Nearly every tool maps to a distinct operation, so the count is reasonable rather than bloated.
Core file and folder lifecycle operations are well covered, including listing, metadata, search, upload, download, copy/move/delete, sharing CRUD, and trash restore/empty. Minor gaps remain, such as no dedicated listing of favorites or direct text-file edit/write operation, but these are largely workable through existing tools.