Search files
Search your files by name, type, size or last change inside one folder.
MCP tool nextcloud_read → search_files
read
Runs a Nextcloud search inside one folder and everything below it, files only. Nextcloud searches within the folder you give, so for the whole account pass the root. Filters combine: a name part, a type such as text/% or application/pdf, a minimum size, a modified date. Results come newest first.
Parameters
| Name | Type | Description |
|---|---|---|
| folder string | string | Folder to search in. Default: '/' (all your files). |
| name_contains string | string | Part of the file name. |
| mime_type string | string | MIME type or pattern, e.g. 'application/pdf' or 'image/%'. |
| min_size_bytes integer | integer | Only files larger than this. |
| modified_since datetime | datetime | Only files changed after this time. |
| limit integer | integer | Maximum results. Default: 50. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "nextcloud_read",
"arguments": {
"operation": "search_files",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"items": [
{
"path": "/Clients/Acme/proposal-q3.pdf",
"size": 388102,
"mime": "application/pdf",
"modified_at": "2026-09-18T14:20:00Z",
"file_id": 48213
}
]
},
"isError": false
}