Gogcli

Skill ddnetters/homelab-agent-skills/gogcli

Use `gog` CLI for Gmail and Google Calendar operations. Trigger when user asks to send/search/read email, manage Gmail labels/drafts/filters, create/update/list calendar events, check availability, or interact with Google Workspace email and scheduling. Also covers auth setup, account management, and output formatting.From its SKILL.md

Install

npx -y skills add ddnetters/homelab-agent-skills --skill gogcli

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

4 things to look at

skips confirmationTells the agent to proceed without asking first, 1 time: "Use `--force` to skip".
reads credentialsReads from 1 credential source: `~/Downloads/client_secret_....json`.
3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
runs commandsInstructs the agent to run 2 commands, including `brew install gogcli` and 1 more.

SKILL.md

3.9 KB, 982 tokens by cl100k_base, as published. Nobody here has run it

gogcli — Gmail & Calendar CLI

gog is a fast, script-friendly CLI for Google Workspace. This skill covers Gmail and Calendar — the two most common services.

Install: brew install gogcli

Quick reference

Auth setup

gog auth credentials ~/Downloads/client_secret_....json
gog auth add [email protected]
export [email protected]

Verify: gog auth list --check

Gmail essentials

# Search
gog gmail search 'newer_than:7d' --max 10
gog gmail search 'from:[email protected] is:unread'

# Read
gog gmail thread get <threadId>
gog gmail get <messageId>

# Send
gog gmail send --to [email protected] --subject "Hi" --body "Hello"
gog gmail send --to [email protected] --subject "Hi" --body-file ./message.txt
gog gmail send --to [email protected] --subject "Report" --body "See attached" --body-html "<p>See attached</p>"

# Reply (threaded, with quoted original)
gog gmail send --reply-to-message-id <messageId> --quote --to [email protected] --subject "Re: Hi" --body "My reply"

# Drafts
gog gmail drafts create --to [email protected] --subject "Draft" --body "Body"
gog gmail drafts list
gog gmail drafts send <draftId>

# Labels
gog gmail labels list
gog gmail thread modify <threadId> --add STARRED --remove INBOX

# Download attachments
gog gmail thread get <threadId> --download --out-dir ./attachments

Calendar essentials

# List events
gog calendar events primary --today
gog calendar events primary --tomorrow
gog calendar events primary --week
gog calendar events primary --days 3
gog calendar events primary --from 2025-01-15 --to 2025-01-20

# All calendars
gog calendar events --all --today

# Search
gog calendar search "standup" --today
gog calendar search "meeting" --days 30

# Create event
gog calendar create primary \
  --summary "Team Sync" \
  --from 2025-01-15T14:00:00Z \
  --to 2025-01-15T15:00:00Z \
  --attendees "[email protected],[email protected]" \
  --location "Zoom"

# Update event
gog calendar update primary <eventId> \
  --summary "Updated Meeting" \
  --from 2025-01-15T11:00:00Z \
  --to 2025-01-15T12:00:00Z

# Delete event
gog calendar delete primary <eventId>

# RSVP
gog calendar respond primary <eventId> --status accepted
gog calendar respond primary <eventId> --status declined

# Check availability
gog calendar freebusy --calendars "primary,[email protected]" \
  --from 2025-01-15T00:00:00Z --to 2025-01-16T00:00:00Z

# Conflicts
gog calendar conflicts --all --today

# Calendars list
gog calendar calendars

Key patterns

Output formats

Default: human-readable tables
--json: machine-readable JSON (stdout), errors on stderr
--plain: stable TSV for piping

Always use --json when chaining commands or parsing output programmatically.

Account selection

# Flag
gog gmail search 'is:unread' --account [email protected]

# Alias
gog auth alias set work [email protected]
gog gmail search 'is:unread' --account work

# Environment (preferred for sessions)
export [email protected]

Confirmation behavior

gog prompts before destructive actions (sending mail, creating events). Use --force to skip, --no-input for CI/scripting.

Send notifications for calendar changes

Pass --send-updates all (or externalOnly) on create/update/delete to notify attendees. Default: no notifications sent.

Extended reference

For complete command reference including filters, batch operations, vacation settings, delegation, recurring events, special event types (focus-time, out-of-office, working-location), and advanced patterns, see references/commands.md.

What ships with it: 1 file

11.5 KB alongside SKILL.md

references/

commands.md11.5 KB