# 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.

> [!IMPORTANT]
> 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](https://docs.plugsight.app/connectors/google-drive.md).

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](https://docs.plugsight.app/developers/calling-tools.md) for the request and response format.

The optional `account` argument takes a Google Drive connection `id` from [`list_accounts`](https://docs.plugsight.app/developers/accounts-tools.md); 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`](#drive_search_files) | Search Google Drive | Read |
| [`drive_read_file`](#drive_read_file) | Read a Google Drive file | Read |
| [`drive_list_drives`](#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:

```bash
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:

```bash
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:

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

## Related articles

- [Google Drive](https://docs.plugsight.app/connectors/google-drive.md)
- [Calling tools](https://docs.plugsight.app/developers/calling-tools.md)
- [Errors](https://docs.plugsight.app/developers/errors.md)
- [Accounts tools](https://docs.plugsight.app/developers/accounts-tools.md)

---

Web version: https://docs.plugsight.app/developers/drive-tools
