file_search
Files & Finder · macOS · Windows
Effect: read (strongest supported action). Status: gated.
Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.
macOS
Purpose
Searches for files and folders by name (case-insensitive, partial match) starting from a root directory. Defaults to the home directory. Returns matching items with path, type, and size, most recently modified first. Office lock files (~$name) are never returned, and nothing under ~/Library is unless root points inside it.
Required inputs
query— Filename pattern to search for (partial, case-insensitive)
Permissions and confirmation
No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.
- Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.
Full input schema — macOS
{
"properties": {
"file_type": {
"description": "Filter by extension, e.g. 'pdf', 'docx', 'xlsx'. Omit for all types.",
"type": "string"
},
"max_results": {
"description": "Maximum number of results to return. Default 50, max 200.",
"type": "integer"
},
"query": {
"description": "Filename pattern to search for (partial, case-insensitive)",
"type": "string"
},
"root": {
"description": "Root directory to search from. Defaults to home directory (~).",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
}Documentation example
Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.
{
"query": "launch checklist"
}Windows
Purpose
Searches for files and folders by name (case-insensitive, partial match) recursively from a root directory. Defaults to the home directory. Returns matching items with path, type and size. Reads anywhere on this PC, except credential and identity locations (browser logins, SSH and cloud keys, Windows credential stores, another user's profile), which are never read.
Required inputs
query— Filename pattern to search for (partial, case-insensitive).
Permissions and confirmation
No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.
- Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.
Full input schema — Windows
{
"properties": {
"file_type": {
"description": "Filter by extension, e.g. 'pdf', 'docx'. Omit for all types.",
"type": "string"
},
"max_results": {
"description": "Maximum results to return (default 50, max 200).",
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Filename pattern to search for (partial, case-insensitive).",
"type": "string"
},
"root": {
"description": "Root directory to search from. Defaults to the home directory (~).",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
}Documentation example
Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.
{
"query": "launch checklist"
}