A fast, script-friendly CLI for Google Workspace services with JSON-first output and multi-account support.
Works with
AI-first code editor with Composer
Before installing skills in Cursor, ensure your development environment meets these requirements:
node --versiongog-cliExecute the skills CLI command in your project's root directory to begin installation:
Fetches gog-cli from intellectronica/agent-skills and configures it for Cursor.
The CLI shows a list of agents. Use arrow keys and space to select Cursor:
Confirm successful installation by checking the skill directory location:
Restart Cursor to activate gog-cli. Access via /gog-cli in your agent's command palette.
We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.
Skills execute code in your environment. Always review source, verify the publisher, and test in isolation before production.
Submit your Claude Code skill and start earning
Automate repetitive workflows and reduce manual effort
Example
Generate reports, summarize documents, draft communications
Save 3-5 hours per week on routine tasks
Learn new skills, understand complex topics, get expert guidance
Example
Explain concepts, provide examples, suggest learning resources
Accelerate learning and skill development by 2x
Enhance output quality through reviews, suggestions, and refinements
Example
Review drafts, suggest improvements, catch errors
Improve work quality by 30-40% with less effort
3
total installs
3
this week
236
GitHub stars
0
upvotes
Run in your terminal
3
installs
3
this week
236
stars
A fast, script-friendly CLI for Google Workspace services with JSON-first output and multi-account support.
Repository: https://github.com/steipete/gogcli
This skill assumes gog is installed and authorised. If commands fail with authentication errors, inform the user they need to:
brew install steipete/tap/gogcligog auth credentials <path-to-credentials.json>gog auth add [email protected] --services allDo not attempt to resolve authentication issues automatically. Provide the user with the relevant command and let them handle it.
Gmail, Calendar, Drive, Docs, Sheets, Slides, Chat (Workspace), Classroom, Contacts, Tasks, People, Groups (Workspace), Keep (Workspace, service account only).
--account <email> # Select account
--client <name> # Select OAuth client
--json # JSON output
--plain # TSV output (for scripting)
--force # Skip confirmations
--no-input # Fail instead of prompting
gog --account [email protected] gmail search "is:unread" # Use specific account
gog gmail search "is:unread" --json | jq '.threads[].id' # JSON for parsing
gog gmail search "is:unread" --plain | cut -f1 # Plain for shell
gog gmail search "is:unread" --max 10 --page <token> # Pagination
gog gmail search "is:unread from:[email protected] newer_than:7d"
gog gmail messages search "is:unread" --include-body
gog gmail thread get <threadId>
gog gmail get <messageId> --format full
# Basic send
gog gmail send --to [email protected] --subject "Hello" --body "Message"
# With HTML and attachments
gog gmail send --to [email protected] --subject "Report" \
--body-html "<h1>Report</h1>" --attach ~/report.pdf
# Reply
gog gmail send --to [email protected] --subject "Re: Original" \
--body "Reply" --reply-to-message-id <messageId>
gog gmail labels list
gog gmail labels create "Project/Subproject"
gog gmail thread modify <threadId> --add "Label" --remove INBOX
For full Gmail reference including drafts, filters, vacation, delegates, tracking, and watch, see references/gmail.md.
gog calendar events primary --from "2024-12-01" --to "2024-12-31" --weekday
gog calendar events primary --query "meeting"
# Create event
gog calendar create primary --summary "Meeting" \
--from "2024-12-20T14:00:00" --to "2024-12-20T15:00:00"
# With attendees and recurrence
gog calendar create primary --summary "Weekly Standup" \
--from "2024-12-20T09:00:00" --to "2024-12-20T09:30:00" \
--attendees "[email protected],[email protected]" \
--rrule "FREQ=WEEKLY;BYDAY=MO,WE,FR"
# Respond
gog calendar respond primary <eventId> --status accepted
gog calendar focus-time create primary --from DT --to DT --auto-decline
gog calendar ooo create primary --from DT --to DT --decline-message "Away"
gog calendar working-location create primary --from DT --to DT --location home
For full Calendar reference, see references/calendar.md.
gog drive ls --parent <folderId>
gog drive search "quarterly report"
gog drive download <fileId> --out ~/Downloads/
gog drive upload ~/report.pdf --parent <folderId>
gog drive mkdir "New Folder" --parent <folderId>
gog drive share <fileId> --email [email protected] --role writer
gog sheets read <spreadsheetId> "Sheet1!A1:D10"
gog sheets write <spreadsheetId> "Sheet1!A1:B2" --values '[["Name","Age"],["Alice",30]]'
gog sheets append <spreadsheetId> "Sheet1!A:B" --values '[["Bob",25]]'
gog sheets format <spreadsheetId> "Sheet1!A1:D1" --bold --bg-color "#FFCC00"
gog docs export <documentId> --format pdf --out ~/doc.pdf
gog slides export <presentationId> --format pptx --out ~/slides.pptx
For full Drive/Docs/Sheets/Slides reference, see references/drive-docs.md.
gog tasks lists
gog tasks list <tasklistId>
gog tasks add <tasklistId> --title "Buy groceries" --due "2024-12-20"
gog tasks add <tasklistId> --title "Weekly review" --due "2024-12-20" --repeat weekly
gog tasks done <tasklistId> <taskId>
gog contacts search "john"
gog contacts create --given "John" --family "Doe" --email "[email protected]"
gog contacts directory search "smith" # Workspace
gog classroom courses --state ACTIVE
gog classroom students <courseId>
gog classroom coursework create <courseId> --title "Homework" --type ASSIGNMENT --due "2024-12-31T23:59:59Z"
gog classroom submissions grade <courseId> <courseworkId> <submissionId> --grade 95
For Classroom, Chat, Contacts, Tasks, People, Groups, Keep, see references/other-services.md.
~/Library/Application Support/gogcli/config.json~/.config/gogcli/config.json%AppData%\gogcli\config.jsongog config set default_timezone America/New_York
gog config set default_account [email protected]
gog config list
GOG_ACCOUNT=[email protected] # Default account
GOG_CLIENT=work # OAuth client
GOG_JSON=1 # Default JSON output
GOG_PLAIN=1 # Default plain output
GOG_TIMEZONE=America/New_York # Display timezone
GOG_ENABLE_COMMANDS=calendar,tasks # Command allowlist
For full configuration, see references/configuration.md.
gog --account [email protected] gmail search "is:unread"
gog auth alias set work [email protected]
gog --account work gmail search "is:unread"
gog auth list --check
For authentication including service accounts, see references/authentication.md.
# JSON processing
gog gmail search "is:unread" --json | jq -r '.threads[].id'
# Batch operations
gog gmail search "older_than:30d" --json | \
jq -r '.threads[].id' | \
xargs -I {} gog gmail thread modify {} --add Archive --remove INBOX
# Non-interactive
gog gmail send --to [email protected] --subject "Test" --body "Hi" --force
If commands fail, inform the user of the likely cause:
| Error | Cause | Solution |
|---|---|---|
no credentials |
OAuth not configured | gog auth credentials <file> |
token expired |
Auth invalid | gog auth add <email> --force-consent |
insufficient scope |
Missing permissions | gog auth add <email> --services <services> |
command not found |
Not installed | brew install steipete/tap/gogcli |
Status checks:
gog auth list --check
gog auth status
references/command-reference.md - Complete command specificationreferences/authentication.md - Auth, credentials, multi-accountreferences/configuration.md - Config and environment variablesreferences/gmail.md - Gmail operationsreferences/calendar.md - Calendar operationsreferences/drive-docs.md - Drive, Docs, Sheets, Slidesreferences/other-services.md - Classroom, Chat, Contacts, Tasks, People, Groups, KeepPrerequisites
Time Estimate
15-45 minutes depending on use case complexity
Steps
Common Pitfalls
✓ Do
✗ Don't
💡 Pro Tips
✓ Use when
Use when skill capabilities match your task, clear ROI on time saved, and you can validate outputs. Best for repetitive tasks, learning, and quality improvement.
✗ Avoid when
Avoid when task requires deep expertise you can't validate, involves sensitive decisions, or when learning process is more valuable than speed of completion.
intellectronica/agent-skills
jwynia/agent-skills
mindrally/skills
kostja94/marketing-skills
github/awesome-copilot
wispbit-ai/skills
gog-cli fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
We added gog-cli from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
Registry listing for gog-cli matched our evaluation — installs cleanly and behaves as described in the markdown.
I recommend gog-cli for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
gog-cli fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
I recommend gog-cli for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
gog-cli has been reliable in day-to-day use. Documentation quality is above average for community skills.
Solid pick for teams standardizing on skills: gog-cli is focused, and the summary matches what you get after install.
Registry listing for gog-cli matched our evaluation — installs cleanly and behaves as described in the markdown.
gog-cli fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
showing 1-10 of 45