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
Decision gist · record as of 2026-07-28
Google Workspace skill connects Gmail, Calendar, Drive, Sheets, and Docs to your agent via OAuth. 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.
Use it when
- Google Workspace handles OAuth2 setup with flexible service scoping during configuration.
- Google Workspace lets you create, list, and manage Google Calendar events programmatically.
Verify before relying
Read SKILL.md below before installing (6 files). Open directory: indexed for reading, not audited.
Install
NousResearch/hermes-agent/google-workspace · repository language: Python
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently 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)
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
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Integrate Gmail, Calendar, Drive, Sheets, and Docs with agent workflows”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
Google Workspace integrates Gmail, Calendar, Drive, Contacts, Sheets, and Docs into Hermes through managed OAuth2 authentication. The skill leverages the Google Workspace CLI for extended API coverage when installed, otherwise falling back to Python client libraries for core functionality.
Google Workspace brings Gmail, Calendar, Drive, Sheets, and Docs into your agent through a Python wrapper around Google's official gws CLI. Setup handles OAuth2 authorization once, then token refresh happens automatically. Search emails, manage events, query files, read spreadsheets, and access contacts—all via a unified command interface.
Control Google Calendar, Gmail, Drive, and Docs through conversational commands backed by Google's official MCP Server. Schedule meetings, search and compose emails, and organize files using plain language—all with OAuth2 security and no third-party intermediaries.
Google Workspace CLI (`gws`) brings Google Workspace API automation to the command line, handling Drive files, Docs, Sheets, Gmail messages, Calendar events, and Chat spaces with structured JSON responses. Use it to read, list, and mutate Workspace resources while confirming IDs and respecting API limits.
Google Drive integrates Drive v3 API operations—search, list, upload, download, copy, move, share, and permission management—through the gws CLI. Requires gws authenticated against a Google account with appropriate Drive scopes. Use this skill to locate files, manage folders and shared drives, adjust sharing settings, or pull file metadata into other workflows.
Interact with Google Drive files you've explicitly selected, created, or shared with the app using the Drive v3 REST API. The skill supports reading, downloading, exporting, renaming, moving, and deleting files through curl and jq, with optional upload support via Google's Workspace CLI. Note that the connector operates under the drive.file scope and cannot browse or search your entire Drive.
More skills Google Workspace Cli (unlicensed) · gdrive-access (MIT) · gws-setup (MIT) · gws (MIT) · Gws (unlicensed) · design-md (MIT)