skills.rest
jamsdoescode
jamsdoescodeCOMMUNITY
Explore all skills by this author →
GitHub

google-workspace-gogcli

Operate Gmail, Calendar, Drive, and other Google Workspace services through the local gogcli command-line tool.

Updated Jul 7, 2026
Search Tags:#automation#oauth#cli#gmail#calendar#google workspace#drive
One-click install
npx skills add https://github.com/jamsdoescode/Erik-s-Portfolio --skill google-workspace-gogcli-jamsdoescode
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: google-workspace-gogcli
Source: https://github.com/jamsdoescode/Erik-s-Portfolio/tree/main/openclicky/AppResources/OpenClicky/OpenClickyBundledSkills/google-workspace-gogcli
Command: npx skills add https://github.com/jamsdoescode/Erik-s-Portfolio --skill google-workspace-gogcli-jamsdoescode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It lets an AI agent perform Google Workspace tasks—reading Gmail, listing Calendar events, searching Drive, and more—through the locally installed gogcli (gog) CLI without hosted OAuth or server-side credential storage. ## Core Features & Use Cases - Local CLI Integration: Uses the gog binary with credentials stored in the user's OS keyring, keeping auth fully local. - Broad Service Coverage: Supports Gmail, Calendar, Drive, Docs, Sheets, Slides, Chat, Contacts, Tasks, Groups, Admin, Classroom, Forms, Apps Script, People, and Keep. - Safety-First Writes: Enforces read-only defaults, explicit approval before sends/deletes/edits, and respects guardrails like GOG_GMAIL_NO_SEND and command allowlists. - Use Case: Ask the agent to search your work Gmail for messages from the last 7 days; it verifies gog auth status, runs gog gmail search 'newer_than:7d' --account work --json, and returns concise results. ## Quick Start Ask the agent to check gog auth status and then list your upcoming Calendar events for your work account.

Frequently Asked Questions about google-workspace-gogcli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect an AI agent to Gmail and Google Calendar locally?▼

Install gogcli with `brew install gogcli`, store a Google Cloud Desktop OAuth client JSON via `gog auth credentials`, then authorize an account with `gog auth add [email protected] --services gmail,calendar`. The agent then runs read-only `gog` commands with `--json` output.

How do I search Gmail messages from the command line with gog?▼

Use `gog gmail search '<query>' --account work --json` for thread search or `gog gmail messages search '<query>' --max 10 --json` for individual messages. Standard Gmail search operators like `newer_than:7d` and `from:` are supported.

Does gogcli store Google credentials in the cloud?▼

No. gogcli stores OAuth credentials locally in the macOS Keychain or an encrypted file keyring under the user's account. There is no hosted login, server-side OAuth, or repository-stored secrets.

Why does gog auth list ask for a keyring passphrase?▼

The file keyring backend requires a passphrase, which must be provided to the agent as the `GOG_KEYRING_PASSWORD` environment variable, typically in `~/.config/openclicky/secrets.env`. Alternatively, migrate gogcli to the macOS Keychain backend.

Can the agent send emails or delete files automatically with gog?▼

No. Sends, deletes, calendar modifications, and document edits require explicit user approval immediately before execution. Setting `GOG_GMAIL_NO_SEND=1` blocks mail sending unless explicitly bypassed for one approved send.

What should I do when a gog command fails with 'expected one of'?▼

Run the parent help command, such as `gog gmail messages -h`, to see the current valid subcommands, then retry with a listed subcommand. The installed `gog --help` output is the source of truth over stale examples.

Related Skills

Explore More Personal & Entrepreneur Skills→
tapanshahtapanshah

gdocs-setup

Configure Google Cloud project, APIs, and OAuth credentials for Google Docs integration.

Community
Intermediate
Mic92Mic92
25

calendar-cli

Manage calendar events and meeting invitations via command-line interface.

Community
Intermediate
73ai73ai
4

persona-researcher

Organize references, notes, and collaboration data across Drive, Docs, and Sheets.

Official
Intermediate
Open-CuriosityOpen-Curiosity
1.7k

google-workspace-setup

Install and configure gws and gcloud for Google Workspace integration.

Official
Advanced