search_drive_files
Search files by text or raw Drive query inside your SellerSheet workspace.
readGoogle Sheets, Docs & Drive
Call it
In an AI client (MCP)
{
"name": "search_drive_files",
"arguments": {
"query": "<query>"
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/search_drive_files \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"<query>"}'Early access — the Tool API is open on request, contact us.
Arguments
| Name | Type | Description |
|---|---|---|
queryrequired | string | Search text or raw Drive query string. |
rawQuery | boolean | true sends query as a Drive v3 `q` expression (e.g. "name contains 'invoice' and mimeType = 'application/pdf'") — add "and trashed = false" yourself, it is not appended. False (default) matches query against names and file content (fullText contains), trash excluded.Default: false |
parentId | string | the folder to search — the SellerSheet folder the sidebar created or any folder inside it; Drive matches direct children only. Omitted, it covers that folder and the workspace folders in it. A folder outside the workspace is refused. |
max | integer | Maximum number of files to return (default 20).Default: 20 |
Result
Every tool answers {notification, data, human_action}; data carries:
files— List of file objects with id, name, mimeType, size, modifiedTime.
Example
search_drive_files(query="invoice", max=10)
search_drive_files(query="mimeType='application/pdf'", rawQuery=True)