search_files
Find files and folders on macOS using Spotlight-style plain-word queries; filter by kind or folder and return paths, names, sizes, and modified dates.
Instructions
Search files and folders with Spotlight. The query is plain words, like in Spotlight. With 'kind', every word must be in the file name or at the start of a word in the content. Returns path, name, kind, size and modified date. Files that no longer exist are skipped.
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 |
|---|---|---|---|
| kind | No | Only this kind of item. 'document' means Word, Pages, OpenDocument and RTF files. 'text' means plain text, Markdown and code. | |
| limit | No | Most results to return. Default 25, maximum 200. | |
| query | Yes | Words to look for. | |
| folder | No | Search only inside this folder (an absolute path, or one that starts with ~). |