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.