Search files by name, type and date
nextcloud_search_filesSearch Nextcloud files and folders by name, type, or modification date, or list recent changes to see what you were working on. Searches file names only, in one request.
Instructions
Find files and folders anywhere below a folder, searched on the Nextcloud server — fast, one request.
By name: 'query' matches parts of the file name; several words must all appear ('rechnung 2026'). '' is a wildcard ('.pdf', 'Angebot*').
By type: 'type' = image, pdf, document (Word/ODT), spreadsheet (Excel/ODS/CSV), presentation, text, audio, video or folder.
By date: 'modified_after' / 'modified_before' (YYYY-MM-DD).
Without 'query' this lists the most recently changed files — the answer to 'what was I working on'.
This searches names, not content. For words inside files use nextcloud_search_file_contents.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "nextcloud_search_files"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | No | Only search below this folder. Default: everything. | / |
| sort | No | newest | |
| type | No | Restrict to one kind of file. | any |
| limit | No | ||
| query | No | Words or a '*' pattern to match in the file name. Case-insensitive. | |
| offset | No | Skip this many results, for paging. | |
| favorites_only | No | Only items the user marked as favorite. | |
| modified_after | No | Only items changed on/after this date (YYYY-MM-DD). | |
| include_folders | No | Include folders in the results (ignored when 'type' is set). | |
| modified_before | No | Only items changed before this date (YYYY-MM-DD). | |
| response_format | No | 'markdown' for readable output, 'json' for structured data | markdown |