google-workspace

Access Gmail, Calendar, Drive, Sheets, Contacts, and Docs via OAuth with JSON outputs.

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

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?

This Skill removes the friction of manually hopping between Gmail, Calendar, Drive, Sheets, Contacts, and Docs by providing a unified, OAuth-authenticated interface that returns consistent JSON results.

Core Features & Use Cases

  • Non-interactive OAuth setup: Guide-controlled flow that stores and refreshes tokens locally for repeated use.
  • Unified Google operations with JSON output: Gmail search/get/send/reply/labels/label modify, Calendar list/create/delete, Drive search, Contacts list, Sheets get/update/append, and Docs get.
  • Operational safety guardrails: Enforces user confirmation rules for sending email and creating/deleting calendar events (as described in the Skill).
  • Backend flexibility: Uses the gws CLI when installed, otherwise falls back to bundled Python Google API clients while preserving Zeus’ JSON contract.

Quick Start

Set up the Skill and then run the Google Workspace API commands to list your upcoming Calendar events in JSON form for the next week.

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 search and draft replies with JSON output?

You can automate Gmail search and draft replies using an OAuth-authenticated interface that queries messages with operators and returns consistent JSON results. The workflow supports reading full messages, drafting replies, and modifying labels.

Can I manage Google Calendar events and read Google Sheets through a single API workflow?

Yes, you can manage Google Calendar events and read Google Sheets through a single OAuth-authenticated workflow. It supports listing, creating, and deleting calendar events, alongside reading, updating, and appending spreadsheet ranges.

How do I handle OAuth credentials for Google Workspace automation scripts?

OAuth credentials for Google Workspace automation are handled via a non-interactive setup that stores and refreshes tokens locally. The system requires a client secret and token to perform scope-aware authentication checks for repeated use.

Do I need the gws CLI to run Google Workspace operations, or can I use Python API clients?

You do not strictly need the gws CLI to run Google Workspace operations. The system uses the gws CLI if installed, but otherwise falls back to bundled Python Google API clients while preserving the JSON contract.

What safety guardrails are enforced when sending emails or modifying calendars?

Safety guardrails enforce user confirmation rules before sending emails or creating and deleting calendar events. These operational safety checks prevent unintended write operations during automated Google Workspace tasks.

How do I search Google Drive files and Google Contacts using a JSON API?

You can search Google Drive files and list Google Contacts using a JSON API that provides authenticated access. The interface queries Drive files and retrieves Contacts, returning all results in a structured JSON format.