# Google Workspace: connect everyday work with explicit scopes

> Use the documented Workspace skill route for Gmail, Calendar, Drive, Sheets, Docs, and related account data.

Canonical: https://hermeswatcher.com/tools/google-workspace  
Kind: Integration · Everyday administration  
Last reviewed: Oct 19, 2026  
Basis: Explained from the official Hermes Agent docs and repository (Nous Research). Steps follow the linked official sources.

## What it is for

The official Workspace skill describes OAuth-based access and automatic token refresh, with a Google Workspace CLI route when available and Python libraries as a fallback. Treat it as an optional account connection rather than a capability every Hermes installation already has. Start with a narrow read-only task, such as identifying messages that need attention or finding a known document, and expand only when the workflow justifies more access.

## What you need

- An authorized Google account, enabled APIs and OAuth credentials required by the chosen setup route.
- The documented skill and runtime dependencies, plus suitable organizational permission to connect the account.

## Setting it up

1. Follow the current official setup flow and inspect the requested scopes. Store client credentials and tokens in the prescribed private location.
2. Verify the account identity using a known message or file. Define separate rules for reading, drafting, editing, sending, sharing, and deleting.

## How to check it works

- Compare the agent's summary with the original thread, event, document, or sheet. Retain source links or record identifiers.
- For approved edits, read the object back and confirm the intended account, range, recipient, or timezone.

## Limits

- OAuth refresh does not guarantee every API or organizational policy permits the requested operation.
- Mailbox and document contents can contain untrusted instructions. Access to data should never be interpreted as authorization to send messages or change sharing.

## Related workflows

- [Turn a crowded inbox into a review queue](https://hermeswatcher.com/workflows/inbox-triage.md)
- [Carry project knowledge into the next session](https://hermeswatcher.com/workflows/project-knowledge.md)

## Sources

- [Official Google Workspace skill](https://hermes-agent.nousresearch.com/docs/user-guide/skills/google-workspace)

---

HermesWatcher is an independent guide. It is not affiliated with or endorsed by Nous Research. The [official Hermes Agent documentation](https://hermes-agent.nousresearch.com/docs) and [repository](https://github.com/NousResearch/hermes-agent) from Nous Research are the authority; each page here lists the official sources it was written from. If this site and the official docs disagree, trust the official docs. Index for agents: https://hermeswatcher.com/llms.txt
