google-workspace

Manage Gmail, Calendar, Drive, Contacts, Sheets, and Docs via the gws CLI.

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

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?

Managing Google Workspace services requires navigating complex APIs, handling OAuth2 tokens, and maintaining separate tools for each product, which is time‑consuming and error‑prone.

Core Features & Use Cases

  • Unified OAuth2 setup: One‑click authentication with automatic token refresh.
  • Python wrapper: Consistent command‑line interface that delegates to the gws CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
  • Real‑world example: Quickly list unread emails, schedule meetings, or fetch a spreadsheet without writing any API code.

Quick Start

Ask the skill to list your ten most recent unread emails in Gmail.

Frequently Asked Questions about google-workspace

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

FAQPage Schema
How do I manage Gmail, Calendar, and Drive from a single command line interface?

You can manage Google Workspace data across Gmail, Calendar, Drive, and Docs by using a Python wrapper that delegates commands to a unified CLI, requiring OAuth2 token files like google_client_secret.json for authentication.

How does OAuth2 authentication work when accessing Google Workspace services via CLI?

OAuth2 authentication for Google Workspace CLI access requires google_token.json and google_client_secret.json files, utilizing google-auth-oauthlib to handle one-click setup and automatic token refresh for continuous API access.

Can I query Google Sheets and Contacts without writing API code?

Yes, you can retrieve and manage Google Sheets and Contacts data without writing API code by executing commands through the Python wrapper that delegates to the gws CLI for direct service interaction.

Do I need Python dependencies to send emails or schedule meetings using this approach?

Yes, sending Gmail messages or scheduling Calendar events via the CLI requires installing Python dependencies including google-api-python-client and google-auth-httplib2 to bridge token refresh and command execution.

What is the best way to unify productivity workflows for reading unread emails and fetching spreadsheets?

The best way to unify personal productivity workflows is using a consistent command-line interface that queries unread Gmail messages and fetches Drive spreadsheets through a single OAuth2 authenticated Python bridge.

Why does managing Google Workspace APIs separately become time-consuming and error-prone?

Managing Google Workspace APIs separately becomes time-consuming and error-prone because it requires navigating complex APIs and handling individual OAuth2 tokens for each product instead of using a unified command interface.