Skip to content
Nappai Documentation

Drive Search

Drive Search looks for files in the Google Drive of the account you connect and returns each file’s name, type and the link to open it. You can search by file name, by the text inside, by modification date, by who shares it and by other Google Drive criteria.

Use it when a flow or an agent needs to find a document before reading it, sending it or sharing its link.

When to use it

  • Find a customer’s contract from their name.
  • List the documents changed this week to prepare a summary.
  • Find all the spreadsheets in a shared folder.
  • Give an agent the ability to search Drive for documents when a user asks.

Configuration

You need a Google Drive credential connected to the Google account that holds the files. See Credentials.

FieldWhat it does
Credential (required)The Google Drive credential.
Query Item (required)The search criterion. The most common are name (file name), fullText (text inside), mimeType (file type), modifiedTime (modification date), starred, sharedWithMe and trashed (in the bin). The list includes the other Google Drive criteria.
Valid Operator (required)How the criterion is compared with the value: contains, = (equal), != (not equal), <, <=, >, >= (for dates), in or has. With in, the value is looked for inside the criterion, for example a folder ID with parents finds the files in that folder.
Search ValueThe value you are looking for, for example contract or a date such as 2026-01-01.
Query StringA search written by hand, in Google Drive’s search format, for example name contains 'contract' and trashed = false. If you fill it in, it is used instead of the three fields above.
Max ResultsThe maximum number of files returned. Default: 10.

You must fill in Search Value or Query String; if both are empty, the search fails with an error.

Output

The Data output returns one item per file found, with:

  • title: the file name.
  • url: the link to open it. Google Docs, Sheets, Slides and Drawings open straight in their editor.
  • mime_type: the file type.
  • id: the file’s identifier in Google Drive, which other Drive components ask for to work with it.

The component can also be used as an agent tool with Tool Mode.

Example

A law firm wants its internal assistant to find a client’s contract and share the link.

  1. Add Drive Search and choose the firm’s Google Drive credential.
  2. In Query Item choose name and in Valid Operator, contains.
  3. Connect the client name the user types to Search Value.
  4. Set Max Results to 5.
  5. Connect the Data output to the agent so it answers with the name and link of each contract found.