Skip to main content
Glama
Nextcloud MCP Server

Nextcloud MCP Server

by a-lagutov

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
NEXTCLOUD_URLNoServer URL, e.g. https://cloud.example.com. Optional; overrides the saved value (useful in Docker/CI).
NEXTCLOUD_USERNoLogin name. Optional; overrides the saved value (useful in Docker/CI).
NEXTCLOUD_USER_IDNoInternal user ID, if it differs from the login name (otherwise call login once). Optional; overrides the saved value.
NEXTCLOUD_APP_PASSWORDNoApp 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

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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 login_name and app_password (Settings → Security → App passwords).

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 query lists everything matching the filter.

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 path under its own name. Existing files are skipped unless overwrite=true.

downloadB

Download a file or a whole folder (recursively, parallel) to this machine. local_path is the target file, or an existing folder / path ending with '/' to download into.

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 subfiles also every share inside a folder at any depth

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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.6/5.0

Scored across 23 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count4/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues