Google Workspace

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 | Read a message | | gogcli gmail send --to "..." --subject "..." --body "..." | Send an email | | gogcli gmail reply --body "..." | Reply to a message | | gogcli gmail search "" | Search emails (Gmail syntax) | | gogcli gmail archive | Archive a message | | gogcli gmail trash | 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 | Delete an event | | gogcli calendar search "" | Search events |

Drive

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

Contacts

| Command | Description | |---------|-------------| | gogcli contacts list | List contacts | | gogcli contacts search "" | Search contacts | | gogcli contacts get | Get contact details |

Sheets

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

Docs

| Command | Description | |---------|-------------| | gogcli docs read | Read a document | | gogcli docs create --title "..." | Create a new document | | gogcli docs append --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 "alice@co.com,bob@co.com"

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--.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

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: claude-world
• Source: claude-world/claude-agent
• License: MIT

Install and usage instructions live in the source repository linked above.