google-workspace

Automate Google Workspace tasks via Python scripts with OAuth2 token refresh.

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

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 integration via Python allows Hermes Agent to automate repetitive Google Workspace tasks with token refresh, eliminating manual setup friction and enabling multi-service workflows.

Core Features & Use Cases

  • OAuth2-based authentication with automatic token refresh
  • Python-based API wrappers to manage Gmail, Calendar, Drive, Contacts, Sheets, and Docs across CLI and chat interfaces
  • Use case: schedule emails, fetch calendar events, read or update Drive files, and pull document data for reporting

Quick Start

Run the setup to authenticate with Google and initialize API access for Hermes.

Frequently Asked Questions about google-workspace

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

FAQPage Schema
How do I automate Google Workspace tasks like Gmail and Calendar with Python?

You can automate Google Workspace tasks using Python scripts that wrap Gmail, Calendar, Drive, Sheets, Docs, and Contacts APIs. These scripts support CLI and chat workflows via Telegram or Discord using OAuth2 authentication with automatic token refresh.

Do I need OAuth2 credentials to use the Google Workspace Python API wrappers?

Yes, OAuth2 credentials are required. You must store google_client_secret.json and google_token.json in your environment. The Skill uses Google's Python client libraries to manage authentication and refresh tokens automatically across workflows.

Can I schedule emails and fetch calendar events across CLI and chat interfaces?

Yes, you can schedule emails and fetch calendar events across CLI and chat interfaces. The Python API wrappers support multi-service workflows, allowing Hermes Agent to automate repetitive tasks across Gmail, Calendar, and Drive from a single interface.

What's the best way to read and update Drive files or pull document data for reporting?

The best way to read and update Drive files is through Python-based API wrappers that interact with Google Drive and Docs. These wrappers allow you to pull document data directly for reporting, handling OAuth2 token refresh automatically to maintain access.

Why does my Google Workspace automation stop working after token expiration?

Google Workspace automation fails after token expiration if automatic refresh is not configured. This Skill handles OAuth2 token refresh automatically, ensuring continuous API access for Gmail, Calendar, and Drive tasks without manual re-authentication.

What Python dependencies are required to manage Google Contacts and Sheets via API?

To manage Google Contacts and Sheets via API, you need google-api-python-client, google-auth-oauthlib, and google-auth-httplib2 installed in your Python environment. These libraries enable OAuth2 authentication and API interactions for Workspace automation.