Agent skill
Google Workspace CLI (gog) for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
Install this agent skill to your Project
npx add-skill https://github.com/letta-ai/lettabot/tree/main/.skills/google
SKILL.md
Google Workspace (gog)
Use gog CLI to interact with Google Workspace services.
Setup
brew install steipete/tap/gogcli
gog auth credentials /path/to/credentials.json
gog auth add [email protected] --services gmail,calendar,drive,contacts,docs,sheets
gog auth list
Gmail
# Search emails
gog gmail search 'newer_than:1h is:unread' --account EMAIL --max 10
gog gmail search 'from:[email protected]' --account EMAIL --max 10
# Read email
gog gmail get MESSAGE_ID --account EMAIL
# Send email
gog gmail send --to [email protected] --subject "Subject" --body "Message" --account EMAIL
# Reply to thread
gog gmail send --to [email protected] --subject "Re: Original" --body "Reply" --reply-to-message-id MSG_ID --account EMAIL
# Create/send draft
gog gmail drafts create --to [email protected] --subject "Subject" --body "Draft" --account EMAIL
gog gmail drafts send DRAFT_ID --account EMAIL
# Manage labels
gog gmail labels --account EMAIL
gog gmail modify MESSAGE_ID --add-labels LABEL --account EMAIL
gog gmail modify MESSAGE_ID --remove-labels UNREAD --account EMAIL
Calendar
# List events
gog calendar events CALENDAR_ID --from 2026-01-27T00:00:00Z --to 2026-01-28T00:00:00Z --account EMAIL
# Create event
gog calendar create CALENDAR_ID --summary "Meeting" --from 2026-01-27T10:00:00Z --to 2026-01-27T11:00:00Z --account EMAIL
# Create with color (1-11)
gog calendar create CALENDAR_ID --summary "Meeting" --from ISO --to ISO --event-color 7 --account EMAIL
# Update event
gog calendar update CALENDAR_ID EVENT_ID --summary "New Title" --account EMAIL
# Show available colors
gog calendar colors
Drive
# Search files
gog drive search "query" --max 10 --account EMAIL
# List files in folder
gog drive list FOLDER_ID --account EMAIL
# Download file
gog drive download FILE_ID --out /path/to/file --account EMAIL
# Upload file
gog drive upload /path/to/file --parent FOLDER_ID --account EMAIL
Contacts
# List contacts
gog contacts list --max 20 --account EMAIL
# Search contacts
gog contacts search "name" --account EMAIL
Sheets
# Read range
gog sheets get SHEET_ID "Sheet1!A1:D10" --json --account EMAIL
# Update cells
gog sheets update SHEET_ID "Sheet1!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED --account EMAIL
# Append rows
gog sheets append SHEET_ID "Sheet1!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS --account EMAIL
# Clear range
gog sheets clear SHEET_ID "Sheet1!A2:Z" --account EMAIL
# Get metadata
gog sheets metadata SHEET_ID --json --account EMAIL
Docs
# Read document
gog docs cat DOC_ID --account EMAIL
# Export to file
gog docs export DOC_ID --format txt --out /tmp/doc.txt --account EMAIL
Environment
Set default account in .env:
Email Polling
Emails are polled every 1 minute via cron. Use ignore() if nothing important.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
letta-ai/lettabot
openai-whisper
Local speech-to-text with the Whisper CLI (no API key).
letta-ai/lettabot
himalaya
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
letta-ai/lettabot
bear-notes
Create, search, and manage Bear notes via grizzly CLI.
letta-ai/lettabot
summarize
Summarize or extract text/transcripts from URLs, podcasts, and local files (great fallback for “transcribe this YouTube/video”).
letta-ai/lettabot
nano-banana-pro
Generate or edit images via Gemini 3 Pro Image (Nano Banana Pro).
letta-ai/lettabot
ordercli
Foodora-only CLI for checking past orders and active order status (Deliveroo WIP).
Didn't find tool you were looking for?