> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abundly.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Drive

> Access files, create documents, and work with spreadsheets

Connect Google Drive so your agent can work with files in your Drive account. There are two capabilities you can choose from: file-scoped **Google Drive** and broader **Google Drive (Full Access)**.

## Which capability to use

| Capability                     | Access scope                                                                                                                                                 |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Google Drive**               | Only specific files you share with the agent, plus files the agent creates.                                                                                  |
| **Google Drive (Full Access)** | All drives and folders you approve for the token. Hidden by default — email [support@abundly.ai](mailto:support@abundly.ai) to enable it for your workspace. |

## Authentication modes

The **Google Drive** capability card offers two modes:

* **Personal** — Connect your own Google account and share specific files (the default).
* **Service account** — Reference a Google service account JSON key (stored as a workspace secret). The agent accesses exactly what's shared with the service account's email, with no personal token. Best for autonomous, per-agent access.

To set up service account mode: in Google Cloud, create a service account, enable the Drive API, download its JSON key, and store it as the secret on the capability card. Then share the files or folders the agent needs with the service account's email. The capability card includes step-by-step guidance.

<Note>
  A service account has no storage of its own, so to let the agent **create** files, give it **Content manager** access to a Shared Drive (the whole drive or a folder inside it).
</Note>

## How to enable

<Steps>
  <Step title="Enable the capability">
    Go to **Settings → Capabilities** and enable **Google Drive** or **Google Drive (Full Access)**.
  </Step>

  <Step title="Connect your Google account">
    Click **Create new** to sign in with your Google account and create a personal access token. This token belongs to you and can be managed in your profile settings.

    If you already have a matching Drive token from setting up another agent, you can select it from the dropdown instead.

    <Frame>
      <img src="https://mintcdn.com/abundly/IfOtCm767MuwOOH9/images/google-drive-capability.png?fit=max&auto=format&n=IfOtCm767MuwOOH9&q=85&s=552b51bf8916b3893e3655636bad2f17" alt="Google Drive capability configuration showing token selection" style={{ maxWidth: '400px', height: 'auto' }} width="836" height="1182" data-path="images/google-drive-capability.png" />
    </Frame>
  </Step>

  <Step title="Set access scope">
    * **Google Drive:** On the **Google Drive** capability card (under **Settings → Capabilities**), use the **Files** section to share one or more specific Drive files with your agent. You can remove access later. The agent can also access files it creates itself.
    * **Google Drive (Full Access):** After OAuth, Abundly takes you to a settings page where you can pick which drives (My Drive and any shared drives) to allow, and optionally narrow access to specific folders within each drive. Choose **Allow All & Continue** to keep broad access, or **Save & Continue** to apply a restricted scope from the start.
  </Step>
</Steps>

<Note>
  You can update Full Access drive and folder selections later from **Profile settings → Personal Tokens**.
</Note>

## What your agent can do with Drive files

* **Read:** Google Docs, Sheets, and Slides, plus text files, PDFs, and common Office files (Word, Excel, PowerPoint)
* **Visual PDF extraction:** Extract content from complex PDFs (scanned documents, tables, charts, or tricky layouts) using vision-based page extraction — no need to import the file first
* **Edit:** Google Docs and Google Sheets that the agent has access to
* **Create:** New Google Docs and Google Sheets in your Drive

## If your token expires or is revoked

OAuth tokens refresh automatically in normal use. If your Google Drive access has been revoked or can no longer be refreshed, use **Reconnect** where available (the Drive capability card or **Personal Tokens**) to re-run consent on the same token so agents keep using the existing token reference.

## Example use cases

* **Document creation** — "Create a summary doc in Google Drive from this meeting transcript"
* **Data analysis** — "Read the data from this spreadsheet and give me the key insights"
* **Data entry** — "Remove the toasters product from the pricing spreadsheet"
* **Data updates** — "Update the quarterly report in Drive with the latest figures that John just posted in Slack"