search_files
Search user-selected folders by words to find matching documents, PDFs, images, screenshots, recordings, or videos, returning files best first with the matching passage.
Instructions
Search the folders the user chose under Files (documents, PDFs, pictures, screenshots, recordings and video on their computer) by words. Returns matching files, best first, with the passage that matched. Requires the separate file-access permission.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_files"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| after | No | Optional local day (YYYY-MM-DD): only files dated on or after it. | |
| kinds | No | Optional: only these kinds of file. | |
| limit | No | Maximum files (default 10, maximum 50). | |
| query | Yes | Words to find. | |
| before | No | Optional local day (YYYY-MM-DD): only files dated before it. |