skills.rest
jaredcroxton
jaredcroxtonCOMMUNITY
Explore all skills by this author →
GitHub

google-workspace

Automate Gmail, Calendar, Drive, Contacts, Sheets, and Docs via Hermes-managed OAuth tokens.

Updated May 16, 2026
Search Tags:#automation#oauth#gmail#docs#calendar#drive#sheets
One-click install
npx skills add https://github.com/jaredcroxton/hermes-mirror --skill google-workspace-jaredcroxton
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/jaredcroxton/hermes-mirror/tree/main/agents/skills/productivity/google-workspace
Command: npx skills add https://github.com/jaredcroxton/hermes-mirror --skill google-workspace-jaredcroxton

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires google-api-python-client, google-auth-oauthlib, google-auth-httplib2, and includes scripts (resource) and references (resource) components.

What problem does it solve?

It solves the problem of manually copying, searching, and updating data across Google services by providing a unified, Hermes-managed OAuth workflow for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.

Core Features & Use Cases

  • OAuth Setup & Token Lifecycle: Performs non-interactive OAuth flow setup, stores tokens in the Hermes home, and refreshes access automatically.
  • Gmail Operations: Searches, reads messages, sends, replies, and manages labels while returning a consistent JSON contract.
  • Workspace Coverage for Productivity: Covers Calendar event listing/creation, Drive search/get/upload/download/share/delete (trash-first), Contacts listing, plus Sheets and Docs read/write/append/update operations.
  • Execution Backends: Uses the gws CLI when available for broader coverage, and falls back to the bundled Python Google API client otherwise.
  • Safety Guardrails for Writes: Includes explicit rules requiring user confirmation before performing sensitive write/delete/share actions.

Quick Start

Tell the AI to set up OAuth for Gmail and Calendar, then search unread emails from a specific sender and return the matching message metadata as JSON.

Frequently Asked Questions about google-workspace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Gmail and Google Calendar access with OAuth using Python?▼

Automate Gmail and Calendar access by using a Hermes-managed OAuth workflow that handles non-interactive token setup, stores credentials, and refreshes access automatically. It wraps the Google API client to return structured JSON for email triage and scheduling.

Do I need to manually refresh OAuth tokens for Google Drive and Sheets operations?▼

No, you do not need to manually refresh OAuth tokens for Google Drive and Sheets operations. The Skill manages the OAuth token lifecycle automatically, refreshing access tokens non-interactively so you can read, write, and append spreadsheet data continuously.

Can I use the Google API Python client to search and manage Gmail labels from the command line?▼

Yes, you can use the Google API Python client to search and manage Gmail labels from the command line. It searches messages, sends replies, and manages labels, returning a consistent JSON contract while falling back to the bundled client if the CLI backend is unavailable.

What's the best way to automate document ingestion and export across Google Workspace?▼

Automate document ingestion and export across Google Workspace by using a unified API wrapper that covers Docs, Sheets, Drive, and Contacts. It structures the data into JSON, allowing you to search, read, upload, and download files without manual copying.

Are there safety guardrails for write operations when automating Google Contacts and Drive sharing?▼

Yes, there are explicit safety guardrails for write operations when automating Google Contacts and Drive sharing. The system enforces mandatory user confirmation rules before performing sensitive write, delete, or share actions, including a trash-first deletion approach for Drive files.

Why does my Google Workspace automation require token and OAuth client credential files?▼

Google Workspace automation requires mandatory token and OAuth client credential files to authenticate API requests securely across desktop and server environments. These files establish the non-interactive OAuth flow needed to access Gmail, Calendar, and Drive data.

Related Skills

Explore More Software Engineering Skills→
john-data-chenjohn-data-chen
2

google-workspace

Automate Google Workspace management across Gmail, Calendar, Drive, Docs, Sheets, and Contacts.

Community
Intermediate
adamhjoujadamhjouj
4

gog

Automate Google Workspace tasks from the command line.

Community
Advanced
m13vm13v
312

gws-setup

Automate Google Cloud OAuth app creation and configuration for the GWS CLI.

Community
Advanced
accomplish-aiaccomplish-ai
10.9k

google-workspace

Automate Google Workspace tasks across Docs, Sheets, Gmail, and Drive.

Official
Intermediate