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

# Google Drive

> Connect Google Drive with Qontext

## Overview

The Google Drive connection allows Qontext to ingest documents, presentations, tables, and text files from a connected Google Drive into your context repository.

<Info>
  Only files and folders that the connected Google account can access will be ingested into your context repository.
</Info>

**Supported file types include:**

| File type       | Description      |
| --------------- | ---------------- |
| `Google Docs`   | Documents        |
| `Google Slides` | Presentations    |
| `Google Sheets` | Spreadsheets     |
| `txt`           | Plain text files |
| `md`            | Markdown files   |

***

## Recommended setup

Use a **dedicated integration user** in your Google Workspace to ensure a stable and uninterrupted connection.

<div className="qontext-tip-check-wrapper">
  <Tip> Create a service account such as `qontext@yourcompany.com` and grant it access to the files and folders you want Qontext to ingest. This prevents sync interruptions if employee accounts change or are deactivated.</Tip>
</div>

The integration user will:

* Authenticate the connection between Qontext and Google Drive.
* Access required resources with read and download permissions.

***

## Setting up the connection

You can connect Google Drive from your Qontext workspace, authorize access in Google, then choose what to sync and how often. The steps below walk you through the full flow.

<Info>
  You can also manage all your credentials, including Google Drive, from the **Sources** page.
</Info>

<Steps>
  <Step title="Open Sources in your workspace">
    In the [Qontext app](https://app.qontext.ai), open your workspace and go to the **Sources** tab, then click **+ Connect data source**.

    <img src="https://mintcdn.com/qontext/j3o0tEnncO_MaI30/connections/images/sources_page.png?fit=max&auto=format&n=j3o0tEnncO_MaI30&q=85&s=11648406c2e1aef5cf37535482067443" alt="Sources tab in a Qontext workspace" className="rounded-lg mt-4" style={{ maxWidth: '100%' }} width="2977" height="1856" data-path="connections/images/sources_page.png" />
  </Step>

  <Step title="Select Google Drive as the data source">
    Choose **Google Drive** from the list of available data sources. This starts the Google Drive connection flow.

    <img src="https://mintcdn.com/qontext/QPEmfEYHnv00ykRo/connections/images/qontext_select_integration.png?fit=max&auto=format&n=QPEmfEYHnv00ykRo&q=85&s=333cc38e25e2a6c6003ebe5a0b64d492" alt="Select Google Drive from the list of integrations" className="rounded-lg mt-4" style={{ maxWidth: '100%' }} width="1502" height="1075" data-path="connections/images/qontext_select_integration.png" />
  </Step>

  <Step title="Choose Google account and grant scopes">
    You can **reuse existing Google Drive credentials** (if you’ve already connected this account to Qontext) or **create a new connection**.

    <img src="https://mintcdn.com/qontext/j3o0tEnncO_MaI30/connections/images/google-drive/google_select_credential.png?fit=max&auto=format&n=j3o0tEnncO_MaI30&q=85&s=f08688a72a8af69b45e3f0d5527b8333" alt="Google account selection screen" className="rounded-lg mt-4" style={{ maxWidth: '100%', height: 'auto' }} width="1517" height="855" data-path="connections/images/google-drive/google_select_credential.png" />

    If you create a new connection, select the Google account that has access to the files you want to ingest, and approve the requested OAuth scopes.

    <img src="https://mintcdn.com/qontext/yLBYSiXLqjzPPV31/connections/images/google-drive/google_drive_login.png?fit=max&auto=format&n=yLBYSiXLqjzPPV31&q=85&s=37a99bcb53a0768f5d627b6ba0963f61" alt="Google sign-in" className="rounded-lg mt-4" style={{ maxWidth: '100%', height: 'auto' }} width="2232" height="812" data-path="connections/images/google-drive/google_drive_login.png" />

    <img src="https://mintcdn.com/qontext/yLBYSiXLqjzPPV31/connections/images/google-drive/google_drive_access.png?fit=max&auto=format&n=yLBYSiXLqjzPPV31&q=85&s=b833e4881c79a19fe9ddfef46e865658" alt="Google account access" className="rounded-lg mt-4" style={{ maxWidth: '100%', height: 'auto' }} width="2232" height="1010" data-path="connections/images/google-drive/google_drive_access.png" />
  </Step>

  <Step title="Configure what to sync (filters)" id="configure-what-to-sync-filters">
    Select the folders and files you want Qontext to ingest into your context repository. You can add folders or individual files.

    <img src="https://mintcdn.com/qontext/4AT5TgUmCcWh-GU5/images/google_configure_filters.png?fit=max&auto=format&n=4AT5TgUmCcWh-GU5&q=85&s=177008262382d07cb033b583294c2b1f" alt="Google Drive filters" className="rounded-lg mt-4" style={{ maxWidth: '100%' }} width="1518" height="786" data-path="images/google_configure_filters.png" />

    Click the **+** next to a folder to add it; open the folder to add subfolders or individual files and select them the same way. Files over 10MB or in an unsupported format cannot be selected. Any such files inside a selected folder are excluded from sync automatically.

    <img src="https://mintcdn.com/qontext/j3o0tEnncO_MaI30/connections/images/google-drive/google_select_folders.png?fit=max&auto=format&n=j3o0tEnncO_MaI30&q=85&s=206ad9a8be3dd0fceca9dfc6fc2b4f28" alt="Google Drive folders" className="rounded-lg mt-4" style={{ maxWidth: '100%' }} width="1512" height="1088" data-path="connections/images/google-drive/google_select_folders.png" />

    Selected items appear at the top. Click **All file types** next to a folder to limit which file types are synced from that folder. Use the checkmark next to an item to remove it from the selection.

    <img src="https://mintcdn.com/qontext/j3o0tEnncO_MaI30/connections/images/google-drive/google_select_file_types.png?fit=max&auto=format&n=j3o0tEnncO_MaI30&q=85&s=a01ba9aee0ed800ca7cb44cb3557f39f" alt="Google Drive file types" className="rounded-lg mt-4" style={{ maxWidth: '100%' }} width="1524" height="780" data-path="connections/images/google-drive/google_select_file_types.png" />
  </Step>

  <Step title="Set sync frequency">
    Choose how often Qontext should refresh data from Google Drive (e.g. daily, weekly, monthly). More frequent syncs keep the context repository up to date but use more resources.

    <img src="https://mintcdn.com/qontext/Ku7aGfXZDb7X9YW2/connections/images/qontext_sync_frequency.png?fit=max&auto=format&n=Ku7aGfXZDb7X9YW2&q=85&s=8cc495fad125ccc46466e89f34bd6f81" alt="Sync frequency settings" className="rounded-lg mt-4" style={{ maxWidth: '100%' }} width="1486" height="760" data-path="connections/images/qontext_sync_frequency.png" />
  </Step>

  <Step title="Review and create connection">
    Review your choices (account, filters, frequency), then confirm to create the connection. Qontext will start the initial sync shortly after.

    <img src="https://mintcdn.com/qontext/j3o0tEnncO_MaI30/connections/images/google-drive/google_review_create.png?fit=max&auto=format&n=j3o0tEnncO_MaI30&q=85&s=582c341226b2fffcc39c4711c3efb73a" alt="Review summary and create connection" className="rounded-lg mt-4" style={{ maxWidth: '100%' }} width="1520" height="784" data-path="connections/images/google-drive/google_review_create.png" />
  </Step>
</Steps>

***

## Managing permissions

### Google Drive OAuth scopes

When connecting, you will be asked to grant scopes that allow Qontext to read and download files. Example scope descriptions you may see:

```text theme={null}
- See and download all your Google Drive files
- See information about your Google Drive files
```

These are required for Qontext to read data from Google Drive and ingest it into your context repository.

### Google Drive permissions

* Use a **single person** or **service account** to manage Drive permissions for Qontext. This avoids accidental permission changes that break syncs.
* If you don’t see a file in Qontext’s Drive tree, verify download permissions using the file’s **File info -> Details** and ensure `Viewers and commenters can see the option to download, print, and copy` is enabled.

***

## Sync latency

Qontext preprocesses Drive content before ingesting it into the context repository. The initial synchronization time depends on the volume and type of files. Workspaces with many files may take up to 12 hours to fully index.

<Info>
  Subsequent syncs process **incremental changes** and typically complete much faster than the initial sync.
</Info>

***

## FAQ

<AccordionGroup>
  <Accordion title="Which Google Drive files are supported?">
    Qontext supports Google Docs, Google Slides, Google Sheets, `txt` and `md`. Files that cannot be downloaded or do not contain extractable text will be skipped.
  </Accordion>

  <Accordion title="Can I connect multiple Google Drive accounts?">
    Yes. You can create multiple Google Drive connections at any time in the **Sources** tab in your Qontext workspace.
  </Accordion>

  <Accordion title="How do I manually refresh Google Drive data?">
    Manual refresh for Google Drive connections is available via the **Sources** tab. Navigate to the respective Google Drive connection and open the **Syncs** tab. In the Sync settings, you can select **Resync all data**.

    <img src="https://mintcdn.com/qontext/j3o0tEnncO_MaI30/connections/images/google-drive/google_resync.png?fit=max&auto=format&n=j3o0tEnncO_MaI30&q=85&s=02a9ad5b1f59996813301759daf16ea6" alt="Resync" className="rounded-lg mt-4" style={{ maxWidth: '100%' }} width="2971" height="1839" data-path="connections/images/google-drive/google_resync.png" />
  </Accordion>

  <Accordion title="What happens if I disconnect Google Drive?">
    If you disconnect the Drive connection, no new files will be ingested. Content already ingested from Drive will remain in your context repository. For data removal requests, contact [support@qontext.ai](mailto:support@qontext.ai).
  </Accordion>

  <Accordion title="Is my Google Drive data secure?">
    Yes. All data is encrypted in transit (TLS) and at rest. Qontext only accesses files you explicitly authorize via Google OAuth scopes.
  </Accordion>

  <Accordion title="How can I limit what Qontext accesses?">
    By default, Qontext only ingests files the connected Google account can access. Additionally, you can add [filters](#configure-what-to-sync-filters) to every connection as described in the setup flow.
  </Accordion>
</AccordionGroup>
