google-workspace
Google Workspace skill brings Gmail, Calendar, Drive, Sheets, and Docs into your agent workflows using OAuth2 and a Python-backed CLI. It supports both the bundled client and the optional gws CLI for extended coverage, with flexible service scoping during setup.
Google Workspace skill connects Gmail, Calendar, Drive, Sheets, and Docs to your agent via OAuth.
AI-generated summary based on this skill's SKILL.md
Install
NousResearch/hermes-agent/google-workspace · repository language: Python
git clone https://github.com/NousResearch/hermes-agent
cp -r hermes-agent/skills/productivity/google-workspace ~/.claude/skills/google-workspaceFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
Can google-workspace search and read emails?
Google Workspace supports Gmail search and read operations with advanced filters. You can search messages using Gmail's query syntax, retrieve email content, and manage your inbox programmatically through agent workflows. The skill integrates Gmail directly into your automation pipelines.
How do I set up OAuth2 authentication for Google Workspace services?
Google Workspace handles OAuth2 setup with flexible service scoping during configuration. The skill guides you through credential creation and permission selection, allowing you to choose which Google services (Gmail, Calendar, Drive, Sheets, Docs) your workflows need access to.
What can google-workspace do with Google Calendar events?
Google Workspace lets you create, list, and manage Google Calendar events programmatically. You can schedule events, retrieve calendar data, and integrate calendar operations into your agent workflows for automated scheduling and event coordination.
How does google-workspace handle Google Drive file operations?
Google Workspace supports uploading, downloading, searching, and sharing files on Google Drive. You can manage your Drive storage through agent workflows, including file retrieval, sharing permissions, and search operations with flexible filtering options.
Can I send emails via the Gmail API with google-workspace?
Yes, Google Workspace enables sending emails through the Gmail API. The skill supports composing and sending messages programmatically, integrating email automation into your agent workflows for workspace email operations.
What's the difference between the bundled client and gws CLI?
Google Workspace includes a bundled Python client for core operations and an optional gws CLI for extended coverage and command-line access. Both support Gmail, Calendar, Drive, Sheets, and Docs integration, with the CLI offering additional flexibility for direct terminal-based workflows.
SKILL.md
rendered from the published skill — quoted content, verbatim
Google Workspace
Gmail, Calendar, Drive, Contacts, Sheets, and Docs — through Hermes-managed OAuth and a thin CLI wrapper. When gws is installed, the skill uses it as the execution backend for broader Google Workspace coverage; otherwise it falls back to the bundled Python client implementation.
References
references/gmail-search-syntax.md— Gmail search operators (is:unread, from:, newer_than:, etc.)
Scripts
scripts/setup.py— OAuth2 setup (run once to authorize)scripts/google_api.py— compatibility wrapper CLI. It prefersgwsfor
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 6 files
skills/productivity/google-workspace/SKILL.md
skills/productivity/google-workspace/references/gmail-search-syntax.md
skills/productivity/google-workspace/scripts/_hermes_home.py
skills/productivity/google-workspace/scripts/google_api.py
skills/productivity/google-workspace/scripts/gws_bridge.py
skills/productivity/google-workspace/scripts/setup.py