Set up and use gogcli (gog) for personal Google accounts — Gmail, Drive, Calendar, Tasks, Contacts, Docs, Sheets, and more. Trigger when: user mentions gogcli, gog, personal Gmail, personal Google account, connecting Gmail, Google Drive setup, Google Calendar connection, Google Tasks, or needs CLI access to personal Google services. Also trigger when user says "connect my Gmail", "set up Google", "access my Google Drive", or references gog commands. Trigger for @gmail.com accounts or when user wants CLI-based Google access without MCP server. Do NOT use for accessing Gmail, Drive, or Calendar after the connection is established (use email-triage, document skills, or other skills that read the connected account automatically — the connector is for setup and reconnect flows only, not ongoing usage requests), setting up a managed Google Workspace organization account with admin-level permissions or org-wide delegation (use google-workspace — this skill is for personal consumer @gmail.com accounts only), or accessing non-Google services (use the appropriate connector for other providers). Do NOT use when user wants a guided multi-connector setup covering multiple services at once (use /connect which walks through each service sequentially). google-personal is for direct CLI (gogcli/gog) setup of personal Gmail specifically.
From tandemnpx claudepluginhub binatrixai/tandem-marketplace --plugin tandemThis skill is limited to using the following tools:
evals/evals.jsonreferences/gog-commands.mdExecutes pre-written implementation plans: critically reviews, follows bite-sized steps exactly, runs verifications, tracks progress with checkpoints, uses git worktrees, stops on blockers.
Guides idea refinement into designs: explores context, asks questions one-by-one, proposes approaches, presents sections for approval, writes/review specs before coding.
Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.
Detect from Personal Preferences. Respond in EN/HE/RU. AskUserQuestion if unknown.
gogcli (gog) — fast, script-friendly CLI for Google services. Works with personal Gmail AND Google Workspace accounts. JSON-first output, multi-account support, OS keyring credential storage.
GitHub: https://github.com/steipete/gogcli
Gmail, Calendar, Drive, Docs, Sheets, Slides, Chat, Classroom, Contacts, Tasks, People, Groups, Keep, Forms, Apps Script
google-personal (this skill) — Personal Gmail (@gmail.com) or when user prefers CLI-only approachgoogle-workspace — Company Google accounts needing MCP server mode or admin featuresbrew install gogcli
Download pre-built binary from https://github.com/steipete/gogcli/releases
Or build from source:
git clone https://github.com/steipete/gogcli.git
cd gogcli
make
yay -S gogcli
gog --help
AskUserQuestion: ["I'm on macOS" / "I'm on Windows" / "I'm on Linux"] Then provide the appropriate install command.
Follow these steps in order, guiding the user with AskUserQuestion at each checkpoint.
AskUserQuestion: ["I've downloaded the credentials file" / "I need help with Google Cloud Console" / "Skip — I'll set this up later"]
gog auth credentials ~/Downloads/client_secret_*.json
This opens your browser for OAuth consent. Approve the permissions.
gog auth add you@gmail.com --services all
For specific services only:
gog auth add you@gmail.com --services gmail,calendar,drive,tasks
Available service scopes: user (basic), gmail, calendar, drive, sheets, docs, slides, tasks, contacts, chat, classroom, keep, forms, script, admin, all
gog gmail labels list
gog calendar events primary --from today --to today
AskUserQuestion: ["Connection works!" / "Something went wrong — help me"]
For servers, WSL, SSH sessions without a browser.
gog auth add you@gmail.com --services user --manual
# On remote machine:
gog auth add you@gmail.com --services user --remote --step 1
# Copy URL to local browser, approve, paste code back
gog auth add you@gmail.com --services user --remote --step 2
gog --access-token "$(gcloud auth print-access-token)" gmail labels list
# Set default account
export GOG_ACCOUNT=you@gmail.com
# Or per-command
gog --account personal@gmail.com gmail search 'is:unread'
gog --account work@company.com calendar events primary
gog --json <command> (for scripting, pipe to jq)gog --plain <command> (tab-separated, for spreadsheets)Important for non-technical users:
--yes flag only when you're certain (skips confirmation)~/.gog-assistant/audit.logAfter gog setup, existing Tandem workflow skills use gog via Bash tool:
| Tandem Skill | gog Command |
|---|---|
| email-triage | gog --json gmail search 'newer_than:1d is:unread' |
| email-draft | gog gmail send --to X --subject Y --body Z |
| email-followup | gog --json gmail search 'from:me newer_than:7d' |
| daily-briefing | gog --json calendar events primary --from today --to today |
| task-manager | gog --json tasks list |
| budget-wizard | Export to Sheets: gog sheets append SHEET_ID 'Sheet1' '[["Item","Amount"]]' |
| topic-research | Save to Drive: gog drive upload ./research.md --name "Research Report" |
After connection, update ~/Tandem/CLAUDE.md Tools & Connectors section:
- Google (gog): Connected — Gmail, Calendar, Drive, Tasks, Contacts
Account: you@gmail.com
| Error | Cause | Fix |
|---|---|---|
token expired | OAuth token expired | gog auth add you@gmail.com --services all --force-consent |
scope denied | Missing API permissions | Re-authorize with broader scopes |
API not enabled | API not turned on in Cloud Console | Enable at console.cloud.google.com/apis/library |
keyring unavailable | No OS keyring on headless system | Use --manual auth flow |
command not found | gog not installed or not in PATH | Reinstall via brew or add to PATH |
See references/gog-commands.md for complete command reference organized by service.