google-workspace

Access Google Workspace services via a token-bridged CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/afel6/scal-ai-pipeline --skill google-workspace-afel6
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/afel6/scal-ai-pipeline/tree/main/hermes_skills_library/productivity/google-workspace
Command: npx skills add https://github.com/afel6/scal-ai-pipeline --skill google-workspace-afel6

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?

Provides a unified, scripted interface to Google Workspace services so agents can perform email, calendar, drive, contacts, sheets, and docs operations without manual OAuth handling.

Core Features & Use Cases

  • OAuth2 Token Management: Automated client-secret storage, interactive auth URL generation, token exchange, and automatic token refresh via a bridge script.
  • CLI Delegation: A lightweight Python wrapper that delegates operations to the gws CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs and returns JSON output for programmatic consumption.
  • Use Case: An autonomous agent can triage unread emails, create calendar events with timezone-aware timestamps, search Drive for reports, and read or update spreadsheets as part of a reporting workflow.

Quick Start

Use the google-workspace skill to list upcoming calendar events for the next week and summarize unread Gmail messages.

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 tasks with Python using OAuth2?

You can automate Gmail and Google Calendar tasks with Python OAuth2 by using a token-bridged CLI that delegates operations to Google Workspace services. This requires a valid OAuth2 client_secret and stored token, returning JSON output for programmatic consumption.

What's the best way to read and update Google Sheets in an autonomous agent workflow?

The best way to read and update Google Sheets in an autonomous agent workflow is via a Python wrapper that delegates operations to a gws CLI. It provides scripted access to spreadsheet operations and returns structured JSON output for agent consumption.

Can I search Google Drive files and unread Gmail messages without manual OAuth token handling?

Yes, you can search Google Drive files and unread Gmail messages without manual OAuth token handling by using an automated token bridge. It manages client-secret storage, interactive auth URL generation, token exchange, and automatic token refresh.

Do I need a gws binary and client_secret to script Google Workspace services?

Yes, you need a valid OAuth2 client_secret and the gws binary available in your PATH to script Google Workspace services. The setup and gws_bridge scripts handle automatic token refresh and bridging for your automated workflows.

How does OAuth2 token refresh work when scripting access to Google Docs and Contacts?

OAuth2 token refresh works by utilizing a bridge script that automatically refreshes your stored token. This allows continuous scripted access to read or update Google Docs and Contacts without requiring manual re-authentication during your workflow.

Can I create timezone-aware Calendar events and search Gmail in the same scripted context?

Yes, you can create timezone-aware Calendar events and search Gmail in the same scripted context. A unified Python wrapper delegates these distinct operations to the gws CLI, allowing autonomous agents to perform both tasks programmatically.