gog

# Google Workspace CLI (gog)

Use `gog` for Gmail, Calendar, Drive, Contacts, Sheets, Docs, Tasks, Keep, and more. Requires OAuth setup.

## Setup (One-Time)

```bash
# Add OAuth credentials
gog auth credentials /path/to/client_secret.json

# Authorize account for services
gog auth add you@gmail.com --services gmail,calendar,drive,contacts,docs,sheets,tasks,keep

# Verify setup
gog auth list
```

## Gmail

```bash
# Search threads (grouped by conversation)
gog gmail search ‘newer_than:7d’ --max 10

# Search individual messages
gog gmail messages search “in:inbox from:example.com” --max 20 --account you@example.com

# Send plain text email
gog gmail send --to recipient@example.com --subject “Subject” --body “Message body”

# Send multi-line email (from file)
gog gmail send --to recipient@example.com --subject “Subject” --body-file ./message.txt

# Send from stdin
gog gmail send --to recipient@example.com --subject “Subject” --body-file -

# Send HTML email
gog gmail send --to recipient@example.com --subject “Subject” --body-html “<p>Hello</p>”

# Create draft
gog gmail drafts create --to recipient@example.com --subject “Subject” --body-file ./message.txt

# Send draft
gog gmail drafts send <draftId>

# Reply to message
gog gmail send --to recipient@example.com --subject “Re: Subject” --body “Reply” --reply-to-message-id <msgId>
```

### Email Formatting Tips

- Prefer plain text. Use `--body-file` for multi-paragraph messages.
- `--body` does not unescape `\n`. Use heredoc or `$’Line 1\n\nLine 2’` for inline newlines.
- Use `--body-html` only when rich formatting is needed.
- HTML tags: `<p>`, `<br>`, `<strong>`, `<em>`, `<a href="url">`, `<ul>/<li>`.

Example (plain text via stdin):
```bash
gog gmail send --to recipient@example.com \
  --subject “Meeting Follow-up” \
  --body-file - <<'EOF'
Hi Name,

Thanks for meeting today. Next steps:
- Item one
- Item two

Best regards,
Your Name
EOF
```

## Calendar

```bash
# List events
gog calendar events <calendarId> --from