gdrive_search_files
Google Drive · 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 the synced Google Drive folder for files by name (recursive). Returns up to max_results matches (default 50).
Required inputs
query— Filename pattern to search for
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": {
"max_results": {
"description": "Maximum results (default 50)",
"type": "integer"
},
"query": {
"description": "Filename pattern to search for",
"type": "string"
},
"root": {
"description": "Restrict to this Drive path (optional - defaults to all mounts)",
"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 in Google Drive by name or extension.
Required inputs
query— Search term (matches file name)
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": {
"ext": {
"description": "File extension filter (e.g. '.docx', '.pdf')",
"type": "string"
},
"limit": {
"description": "Max results (default: 20)",
"type": "integer"
},
"query": {
"description": "Search term (matches file name)",
"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"
}