List files
Files and folders inside one folder, with size, type and last change.
MCP tool nextcloud_read → list_files
read
Lists the direct contents of one folder of your Nextcloud, folders first. Each item has its path, size, MIME type and last modified time. Use the paths it returns in the other tools. Pass the root path to see the top level of your files.
Parameters
| Name | Type | Description |
|---|---|---|
| path string required | string | Folder path, e.g. '/Clients/Acme'. Use '/' for the top level. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "nextcloud_read",
"arguments": {
"operation": "list_files",
"arguments": {
"path": "/Clients/Acme"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"items": [
{
"path": "/Clients/Acme/proposal-q3.pdf",
"type": "file",
"size": 388102,
"mime": "application/pdf",
"modified_at": "2026-09-18T14:20:00Z"
},
{
"path": "/Clients/Acme/Contracts",
"type": "folder",
"size": 1204411,
"mime": "httpd/unix-directory",
"modified_at": "2026-10-02T09:05:00Z"
}
]
},
"isError": false
}