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

# Google Workspace

> Connect Google Workspace to discover apps, people, and OAuth usage across your domain.

The **Google Workspace** integration (tagged **App Discovery**) gives you org-wide visibility into which software your teams use — without spreadsheets or chasing departments for answers. Connect from **Integrations** to populate **Apps** and **Team → People** automatically.

<Note>
  **Pair with spend integrations.** Workspace shows *who uses what*. Connect [Gmail](/connect/gmail) or [Google Drive](/connect/google-drive) to import invoices and amounts for the full spend picture.
</Note>

## What you get

| Area                              | What fills in                                                                                                                  |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **[Apps](/features/apps)**        | Every OAuth-connected app in your domain — tracked and untracked — with user counts, last login, and source *Google Workspace* |
| **[Team → People](/team/people)** | Directory users linked to the apps they use, including people who do not have a ClearSpend login yet                           |
| **Renewals**                      | Usage evidence to right-size seats before auto-renew                                                                           |

ClearSpend uses **read-only** OAuth scopes. It never writes to your Google account, and you can revoke access anytime from **Integrations** or your Google admin console.

## Who can connect

**Owners** and **Admins** can connect and disconnect integrations. **Members** and **Viewers** can view connected integrations but cannot start a new connection. See [Roles and permissions](/reference/roles-permissions).

## Connect Google Workspace

<Steps>
  <Step title="Open Integrations">
    Navigate to **Integrations** in the sidebar (or use **Manage Integrations** from the dashboard empty state).
  </Step>

  <Step title="Find Google Workspace">
    Locate the **Google Workspace** card under **App Discovery**.
  </Step>

  <Step title="Click Connect">
    Click **Connect**. A confirmation dialog explains what ClearSpend reads (directory and OAuth discovery data).
  </Step>

  <Step title="Approve OAuth scopes">
    You are redirected to Google's consent screen. Sign in with a Google Workspace account that can authorize read-only access for your organization. Approve the requested scopes.
  </Step>

  <Step title="Wait for the first sync">
    ClearSpend redirects you back to **Integrations** when authorization succeeds. The first discovery pass usually finishes within a few minutes; larger directories can take longer. The integration card shows the linked account and **last sync** time when complete.
  </Step>
</Steps>

<Tip>
  **Deep link:** open `https://app.clearspend.ai/{your-org-id}/integrations?connect=google_workspace` to jump straight to the connect flow (replace `{your-org-id}` with your workspace ID from the URL).
</Tip>

<video controls className="w-full rounded-lg" src="https://assets.clearspend.ai/content/videos/connect_workspace.mp4">
  Your browser does not support the video tag.
</video>

## Connected state

Once Google Workspace is active, its card shows a green status indicator, the linked Google account, how many connections are linked, and the last sync time. Expand the card to see individual linked accounts in the table below.

<video controls className="w-full rounded-lg" src="https://assets.clearspend.ai/content/videos/connected_integrations.mp4">
  Your browser does not support the video tag.
</video>

## What happens after connect

1. **Apps appear on the Apps page** — including shadow IT your finance team may not have approved. Untracked apps can be converted to subscriptions with **Track Subscription**.
2. **People appear under Team → People** — every user discovered from your directory, with source icons showing *Google Workspace*. Click an **Apps** count to open **Apps used by** for that person.
3. **Subscriptions gain context** — when the same vendor shows up in invoice data later, you already know who uses the tool and when they last logged in.

Discovery runs on a schedule in the background. You do not need to re-connect for day-to-day updates.

## Common questions

<AccordionGroup>
  <Accordion title="Who should authorize the connection?">
    A **Workspace Owner** or **Admin** in ClearSpend, signing in with a Google account that can grant org-wide read access. One successful connect applies discovery to your whole domain, not just one team.
  </Accordion>

  <Accordion title="How quickly does data appear?">
    Most organizations see apps within minutes. Very large directories may take longer; check the **last sync** time on the integration card.
  </Accordion>

  <Accordion title="Do I still need Gmail or Google Drive?">
    Yes, if you want invoice amounts and renewal dates imported automatically. Workspace covers usage and discovery; [Gmail](/connect/gmail) and [Google Drive](/connect/google-drive) cover spend documents.
  </Accordion>

  <Accordion title="Does this replace the Chrome extension?">
    No. Workspace covers your whole directory. The [Chrome extension](/connect/chrome-extension) adds in-browser usage signals and quick invoice capture for individual users.
  </Accordion>
</AccordionGroup>

## Disconnect

Return to **Integrations**, expand the **Google Workspace** card, and disconnect the linked account. This revokes ClearSpend's access token for that connection. Historical data already imported remains in your workspace unless your admin policy says otherwise.

## Related

* [Integrations overview](/connect/integrations)
* [Gmail integration](/connect/gmail)
* [Google Drive integration](/connect/google-drive)
* [Apps](/features/apps)
* [People (All Users)](/team/people)
* [How data enters ClearSpend](/connect/how-data-enters)
