PlugsightDocs

Google Drive tools

The Google Drive tools in the developer API, with every argument: search Drive, read files and list shared drives. Coming soon.

Needs: A Google Drive connection (not offered yet). 3 tools, all read-only.

Google Drive is coming soon. Google treats full Drive access as a restricted permission that needs a security audit before an app can offer it to everyone, so Google Drive isn't in the Connector catalog yet and these tools don't appear for any API key. They're listed here so you know what to expect. See Google Drive.

These tools appear in GET /v1/tools only when the API key's MCP server includes a connection of this kind. Call each one with POST /v1/tools/\<name>, sending its arguments as a JSON object. See Calling tools for the request and response format.

The optional account argument takes a Google Drive connection id from list_accounts; leave it out when the MCP server has only one. Drives you've hidden in Plugsight aren't listed and can't be searched or read.

Tool What it does Kind
drive_search_files Search Google Drive Read
drive_read_file Read a Google Drive file Read
drive_list_drives List Google Drive drives Read

Every tool here only reads: none of them changes anything in Google Drive, so none needs confirm.

The example requests fill in only the required arguments, with placeholder values.

drive_search_files

Search Google Drive · Read

Finds files in Google Drive (My Drive and shared drives) by words inside them, name, type, date, owner or folder. Use drive_read_file to read one. Newest first unless searching by text.

Argument Type Required What it is
text string No Words that appear in the file's content or name
name string No Part of the file name
type string No Type of file. One of: document, spreadsheet, presentation, pdf, folder, image.
modified_after string No YYYY-MM-DD
modified_before string No YYYY-MM-DD
owner string No Owner's email address
folder_id string No Only files directly inside this folder
drive_id string No A shared drive id from drive_list_drives, or "my-drive"
limit integer No Most results to return. From 1 to 100. Default 25.
page_token string No next_page_token from a previous call
account string No Connection id from list_accounts (optional when there's only one of this type)

Example request:

curl -X POST https://app.plugsight.app/v1/tools/drive_search_files \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

drive_read_file

Read a Google Drive file · Read

Reads a file as text: Google Docs, Sheets (every sheet) and Slides, PDFs, Word, Excel, PowerPoint, CSV and text files.

Argument Type Required What it is
file_id string Yes File id from drive_search_files
max_chars integer No Longest text returned; longer files are cut. From 1,000 to 200,000. Default 40000.
account string No Connection id from list_accounts (optional when there's only one of this type)

Example request:

curl -X POST https://app.plugsight.app/v1/tools/drive_read_file \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"file_id": "…"}'

drive_list_drives

List Google Drive drives · Read

My Drive and the shared drives this connection can use. Use a drive's id to search inside it.

Argument Type Required What it is
account string No Connection id from list_accounts (optional when there's only one of this type)

Example request:

curl -X POST https://app.plugsight.app/v1/tools/drive_list_drives \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'