google-workspace

Access Gmail, Calendar, Drive, Contacts, Sheets, and Docs via Python with OAuth2.

Updated Mar 2, 2026
One-click install
npx skills add https://github.com/gigagiova/hermes-agent --skill google-workspace-gigagiova
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/gigagiova/hermes-agent/tree/main/skills/productivity/google-workspace
Command: npx skills add https://github.com/gigagiova/hermes-agent --skill google-workspace-gigagiova

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?

Gmail, Calendar, Drive, Contacts, Sheets, and Docs — all through Python scripts in this skill. No external binaries to install.

Core Features & Use Cases

  • Google Workspace integration via Python client libraries to perform common admin and personal automation tasks.
  • No external binaries required; runs in the Hermes venv and supports OAuth2 with automatic token refresh.
  • Use cases include reading Gmail, listing calendar events, and reading/writing to Drive, Sheets, and Docs from Hermes tasks.

Quick Start

Authenticate with setup.py, then use the Google API CLI wrapper to access Gmail, Calendar, Drive, Contacts, Sheets, and Docs.

Frequently Asked Questions about google-workspace

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

FAQPage Schema
How do I access Gmail, Calendar, and Google Drive from Python scripts without installing external binaries?

You can access Gmail, Calendar, and Google Drive from Python scripts by using the Google Workspace skill, which relies on Google's Python client libraries within the Hermes virtual environment to perform authenticated API calls without external binaries.

How does OAuth2 authentication work when automating Google Sheets and Docs tasks in Python?

OAuth2 authentication for automating Google Sheets and Docs tasks in Python requires a stored client secret and a setup script, enabling automatic token refresh for continuous authenticated access across Hermes workflows.

Do I need Google API Python client libraries to manage Gmail and Calendar in Hermes?

Yes, managing Gmail and Calendar in Hermes requires installing the google-api-python-client, google-auth-oauthlib, and google-auth-httplib2 dependencies in your Hermes virtual environment to handle OAuth2 and API calls.

What is the best way to integrate Google Workspace automation into CLI, messaging, and automation workflows?

The best way to integrate Google Workspace automation into CLI, messaging, and automation workflows is using a unified Python skill that manages email, calendar scheduling, and document retrieval via OAuth2 with automatic token refresh.

Can I read and write to Google Drive, Sheets, and Docs from Hermes tasks?

Yes, you can read and write to Google Drive, Sheets, and Docs directly from Hermes tasks by running the setup.py authentication script and using the provided Google API CLI wrapper for document retrieval and modification.

Why does my Google Workspace API authentication fail or require re-authentication during Python automation?

Google Workspace API authentication can fail if the OAuth client secret is missing or invalid, but this skill applies automatic token refresh to maintain persistent authenticated access across Gmail, Calendar, and Drive API calls.