google-workspace

name	google-workspace
description	Interact with Google Workspace (Gmail, Calendar, Drive, Contacts, Sheets, Docs) via the gogcli CLI. Use when user needs to read/send Gmail, check calendar, manage Drive files, look up contacts, or work with Sheets/Docs.
allowed-tools	["Bash","Read","Write"]
model	sonnet
user-invocable	true
when_to_use	When user needs to interact with any Google Workspace product. Triggers: "check Gmail", "send email via Google", "what's on my calendar", "find file in Drive", "create Google Doc", "update spreadsheet", "search contacts", "schedule meeting", "next calendar event".
argument-hint	<product: gmail|calendar|drive|contacts|sheets|docs> <action> <details>

Google Workspace

Access Gmail, Calendar, Drive, Contacts, Sheets, and Docs via the gogcli CLI.

Prerequisites

brew install steipete/tap/gogcli

Authenticate:

gogcli auth login

This opens a browser for Google OAuth. Grant the requested scopes. Confirm with:

gogcli auth status

Commands

Gmail

Command	Description
gogcli gmail list	List inbox messages
gogcli gmail read <id>	Read a message
gogcli gmail send --to "..." --subject "..." --body "..."	Send an email
gogcli gmail reply <id> --body "..."	Reply to a message
gogcli gmail search "<query>"	Search emails (Gmail syntax)
gogcli gmail archive <id>	Archive a message
gogcli gmail trash <id>	Move to trash

Calendar

Command	Description
gogcli calendar list	List upcoming events
gogcli calendar list --days 7	Events in next 7 days
gogcli calendar create --title "..." --start "..." --end "..."	Create an event
gogcli calendar delete <id>	Delete an event
gogcli calendar search "<query>"	Search events

Drive

Command	Description
gogcli drive list	List files in Drive root
gogcli drive search "<query>"	Search files
gogcli drive download <id>	Download a file
gogcli drive upload <path>	Upload a file
gogcli drive share <id> --email "..." --role reader	Share a file

Contacts

Command	Description
gogcli contacts list	List contacts
gogcli contacts search "<name or email>"	Search contacts
gogcli contacts get <id>	Get contact details

Sheets

Command	Description
gogcli sheets read <id>	Read spreadsheet data
gogcli sheets update <id> --range "A1" --value "..."	Update a cell
gogcli sheets append <id> --range "A1" --values "[...]"	Append rows

Docs

Command	Description
gogcli docs read <id>	Read a document
gogcli docs create --title "..."	Create a new document
gogcli docs append <id> --text "..."	Append text to a document

Usage Examples

Check today's calendar:

gogcli calendar list --days 1

Search Gmail for an invoice:

gogcli gmail search "from:billing subject:invoice has:attachment"

Find a file in Drive:

gogcli drive search "Q1 report filetype:pdf"

Create a calendar event:

gogcli calendar create \
  --title "Team standup" \
  --start "2026-03-22T10:00:00" \
  --end "2026-03-22T10:30:00" \
  --attendees "[e-mail],[e-mail]"

Look up a contact's email:

gogcli contacts search "Alice Chen"

Rules

• Always check if CLI is installed and authenticated: gogcli auth status
• If not installed, show brew install steipete/tap/gogcli and stop
• If not authenticated, show gogcli auth login and stop
• NEVER expose OAuth tokens or credentials in responses
• When reading long emails or documents, truncate at 1000 chars and save full content to workspace/gws-<type>-<id>.md
• When listing calendar events, format as: date/time | title | location (if any)
• When sending emails, draft the content and confirm with the user before executing
• For Sheets operations, always confirm the spreadsheet ID and range before writing
• Keep responses concise: action confirmation in 1-2 lines