google-workspace

Automate Google Workspace APIs via the gws CLI with structured JSON output.

10|1|Updated Feb 5, 2026
One-click install
npx skills add https://github.com/pbc-os/agent-skills-public --skill google-workspace-pbc-os
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/pbc-os/agent-skills-public/tree/main/skills/tier-1-foundation/google-workspace
Command: npx skills add https://github.com/pbc-os/agent-skills-public --skill google-workspace-pbc-os

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a unified command-line interface (CLI) to access and manage all Google Workspace APIs, enabling AI agents to interact with Gmail, Calendar, Drive, Sheets, and more.

Core Features & Use Cases

  • Unified API Access: Control all Google Workspace services through a single, AI-friendly CLI (gws).
  • Dynamic Command Surface: Automatically adapts to new Google API endpoints as they are released.
  • Use Case: An AI agent can use this skill to read your unread emails, schedule a meeting based on your availability, and then upload the meeting agenda to a shared Google Drive folder, all through simple commands.

Quick Start

Install the gws CLI by running npm install -g @googleworkspace/cli and then authenticate with gws auth setup.

Frequently Asked Questions about google-workspace

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

FAQPage Schema
How do I automate Google Workspace tasks like Gmail and Calendar with an AI agent?

To automate Google Workspace tasks, you need a unified CLI that translates AI commands into structured JSON outputs for Gmail, Calendar, and Drive APIs. This allows agents to read emails, schedule meetings, and manage files dynamically.

Can I manage Google Drive and Sheets through a single API integration?

Yes, you can manage Drive and Sheets through a single API integration. A unified command-line interface provides access to the full suite of Google Workspace APIs, returning structured JSON data from dynamic API calls for your AI agent.

Do I need a Google Cloud project to integrate Gmail API with my AI automation workflow?

Yes, you need a Google Cloud project setup for authentication to integrate the Gmail API. Your environment must also have Node.js 18+ installed to run the required command-line interface for AI agent operations.

What is the best way to provide Google Workspace API access to AI agents?

The best way to provide Google Workspace API access is via an AI-friendly command-line interface. It automatically adapts to new Google API endpoints and outputs structured JSON, enabling seamless automation of business operations across services like Docs and Tasks.

Does this Google Workspace automation CLI support Google Chat and Tasks?

Yes, this Google Workspace automation CLI supports Google Chat and Tasks. It connects AI agents to the full suite of Workspace APIs, enabling structured interactions with dynamic endpoints across all included productivity services.

Why use a CLI for Google Calendar API integration instead of direct API calls?

Using a CLI for Google Calendar API integration provides an AI-friendly command surface that abstracts direct API calls. It automatically adapts to new endpoints and returns structured JSON, simplifying business operations automation.