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 '{}'