gws

Control Google Workspace services from a single CLI.

52|4|Updated Oct 23, 2025
One-click install
npx skills add https://github.com/vaayne/agent-kit --skill gws-vaayne
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws
Source: https://github.com/vaayne/agent-kit/tree/main/skills/gws
Command: npx skills add https://github.com/vaayne/agent-kit --skill gws-vaayne

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Gmail, Drive, Sheets, Calendar, Docs, Tasks, and Chat require separate interfaces and fragmented workflows. This skill unifies common Google Workspace operations under a single command-line interface to speed up admin and user tasks.

Core Features & Use Cases

  • Manage Gmail, Drive, Sheets, Calendar, Docs, Tasks, and Chat from one tool.
  • Automate multi-service workflows, e.g., creating a calendar event and notifying a team via chat.
  • Use cases include inbox triage, file operations, spreadsheet updates, and task tracking, all via simple gws commands.

Quick Start

Ask gws to list unread Gmail messages.

Frequently Asked Questions about gws

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

FAQPage Schema
How do I automate Google Workspace workflows across Gmail, Drive, and Calendar?

You can automate Google Workspace workflows by using a single CLI to execute commands across Gmail, Drive, Sheets, Calendar, and Docs. It supports flags, JSON payloads, and dry-run options to streamline multi-service operations.

What is the best way to triage my Gmail inbox via the command line?

Triage your Gmail inbox by running CLI commands to list unread messages. The tool unifies Gmail operations, allowing you to manage emails directly from the terminal without fragmented web interfaces.

Can I manage Google Drive files and Google Sheets spreadsheets from a single CLI?

Yes, you can manage Google Drive files and update Google Sheets spreadsheets from a single CLI. It consolidates file operations and spreadsheet updates into simple commands with configurable output formats.

Does this Google Workspace CLI tool require separate authentication for each service?

No, the Google Workspace CLI handles authentication flows centrally, so you do not need separate authentication for each service. This allows you to seamlessly interact with Gmail, Drive, and Calendar under one interface.

How do I create a Calendar event and notify a team via Google Chat automatically?

Automate multi-service workflows by running a CLI command that creates a Google Calendar event and triggers a notification via Google Chat. This unifies task tracking and team communication into a single operation.

What are the limitations of using a command line interface for Google Workspace operations?

Using a CLI for Google Workspace operations requires familiarity with command-line syntax and JSON payloads for complex parameters. It is designed for automation and admin tasks rather than visual document editing or manual scheduling.