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

> ## Agent Instructions
> These docs moved from docs.flintai.dev to docs.switchagents.ai. Use docs.switchagents.ai for every link and request.
> To search these docs from an AI tool, connect the MCP server at https://docs.switchagents.ai/mcp. The page index is at https://docs.switchagents.ai/llms.txt.
> The source code for these products is public on GitHub. Switch Rooms: https://github.com/sandbox-quantum/switch. Switch Trust CLI: https://github.com/sandbox-quantum/switch-trust-cli. Switch Trust CodeScan action: https://github.com/sandbox-quantum/switch-trust-codescan-action. Switch Trust MCP server: https://github.com/sandbox-quantum/switch-trust-mcp. Switch Trust Python SDK: https://github.com/sandbox-quantum/switch-trust-sdk-py. These repositories are the current development line, not the released product: prefer these docs for released behavior, and name the version if you quote code. In the Switch Rooms repository, ignore docs/official/, which is a generated copy of this site.

# Connect Google Workspace

> Let your Switch agents work with Google Drive, Docs, Sheets, Slides, and Calendar as you

With Google Workspace connected, your agents can work with Google Drive, Docs, Sheets, Slides, and Calendar as you. For how connectors work across services, see [Let your agents use your services](https://docs.switchagents.ai/switch-rooms/getting-started/connectors/index.md).

## Before you begin

* **Connectors turned on for your server, with Google Workspace set up.** If its card shows **Unavailable**, ask the administrator of your Switch server to set it up.
* **The Google account you want agents to use.** Agents act as that account, with everything it can see and change. There's no read-only option for Google Workspace.
* **Whether the agent asks for approval.** It depends on the agent's provider and settings. See [Check whether an agent asks for approval](https://docs.switchagents.ai/switch-rooms/getting-started/connectors/index.md#check-whether-an-agent-asks-for-approval).

## Connect Google Workspace

**1. Start the connection**

In the Switch Console sidebar, select **Connectors**, then the **Discover** tab. Select **Google Workspace**, then **Connect to Switch**, then **Connect Google Workspace**. Your browser opens, and Switch Console waits while you sign in.

**2. Choose the right Google account**

Google shows an account chooser first. Pick the account your agents should use, not a personal account you're also signed in to.

**3. Allow access**

Google lists what Switch asks for: to see, edit, create, and delete your Drive files, Docs, Sheets, and Slides, and to view and edit your Calendar. Select **Allow**. The app name on this screen is the one the administrator of your Switch server registered with Google.

**4. Return to Switch Console**

When the page says you're signed in and connected, close the tab. The Google Workspace page in Switch Console shows **Connected as** with your account, and **Read and write**.

Then turn Google Workspace on for each agent that needs it. See [Turn a connector on for an agent](https://docs.switchagents.ai/switch-rooms/getting-started/connectors/index.md#turn-a-connector-on-for-an-agent). To check it works, start a new [session](https://docs.switchagents.ai/switch-rooms/resources/glossary.md#session) with the agent, then ask it something small, such as *list the files I changed in Drive this week*.

## Cut off access

**To stop one agent,** open the agent's page, select the plug icon, and turn Google Workspace off. **To stop every agent,** on the Google Workspace page under **Connectors**, select **Disconnect**.

* **Access already handed out lasts up to about an hour.** After you turn Google Workspace off for an agent, access the agent already holds keeps working for up to about an hour.
* **Disconnecting removes the sign-in Switch holds for your Google account.** Switch stops handing out new access. Access an agent already holds keeps working for up to about an hour.
* **To end access sooner,** in your Google account's settings for third-party apps, remove the access you gave Switch.

## Troubleshooting

> [accordion] Agents are using the wrong Google account
>
> **You picked a different account in the Google account chooser.** On the Google Workspace page in Switch Console, select **Disconnect**, then connect again and pick the right account.

## Next steps

> [card] [Let your agents use your services](https://docs.switchagents.ai/switch-rooms/getting-started/connectors/index.md)
>
> Connect another service, or check how approvals and cutting off access work