What Is Google Workspace CLI for AI Agents?

Google Workspace CLI (gws) is a new command-line tool that brings Gmail, Docs, Sheets, Drive, and other Google Workspace apps into a unified terminal interface — designed for both developers and AI agents.

Last verified: March 2026

Why It Matters

Until now, AI agents could generate text, write code, and browse the web — but they couldn’t easily interact with your Google Workspace. Workspace CLI changes that by providing:

• Terminal access to Workspace — Gmail, Docs, Sheets, Drive from the command line
• AI agent integration — Gemini CLI extension gives agents direct access to gws commands
• Automation pipelines — Chain Workspace operations into scripts and workflows
• MCP compatibility — Works with Model Context Protocol for cross-agent interoperability

What AI Agents Can Do With It

Workspace App	Agent Capabilities
Gmail	Read, compose, send emails; search and organize
Google Docs	Create, read, edit documents
Google Sheets	Read data, write cells, create spreadsheets
Google Drive	List, search, upload, download files
Google Calendar	View, create, modify events

Example Use Cases

Research Agent

An AI agent reads emails about a topic, pulls related documents from Drive, summarizes key points into a new Google Doc, and emails the summary to your team.

Data Pipeline

Agent pulls data from Sheets, processes it, writes results to a new Sheet, and creates a Docs report with charts.

Email Assistant

Agent monitors Gmail for specific types of messages, drafts responses, and organizes threads into labels.

How to Get Started

# Install Google Workspace CLI
npm install -g @google/workspace-cli

# Authenticate
gws auth login

# List recent emails
gws gmail list --limit 10

# Create a new document
gws docs create --title "Meeting Notes" --content "..."

With Gemini CLI

The Gemini CLI extension enables natural language control:

gemini "Summarize my last 5 emails about the Q1 report 
and save the summary to a new Google Doc"

Security Considerations

• OAuth authentication — Standard Google OAuth with scope-based permissions
• Audit logging — All agent actions are logged in Google Workspace admin
• Scope limits — You control which Workspace apps the agent can access
• Token management — Authentication tokens can be scoped and revoked

The Bigger Picture

Google Workspace CLI is part of a trend toward making enterprise tools accessible to AI agents:

• Google → Workspace CLI for Gemini agents
• Microsoft → Copilot Agents for Microsoft 365
• Anthropic → MCP servers for various enterprise tools

This is how AI agents go from “helpful chatbot” to “productive team member” — by gaining access to the same tools humans use.