You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
spotlight_query tool: runs a raw Spotlight query and returns the paths of matching files, in Spotlight's order.
search tool: finds files by name_contains (ignoring case and diacritics), kind (image, movie, audio, pdf, folder, application) and folder (an absolute path, ~, or a path starting with ~/), or any combination of them, without Spotlight query syntax.
Both tools take an optional limit, default 25, capped at 100.
Both tools return {"paths": [...]} as structured content, described by an outputSchema, and as JSON in a single text block.
A searchfolder that does not exist, is a file, is a package, or cannot be read returns an error result naming the path and the fix, instead of an empty list.
A searchfolder denied by macOS privacy protection names the Privacy & Security setting to change, and one lacking read permission says so.
A search whose folder contains ~/Downloads, ~/Documents or ~/Desktop, a search without a folder, and every spotlight_query list in unreadableFolders those of the three folders macOS privacy protection denies, each with the setting to change, since Spotlight silently leaves out their files.