How do I install the Google Suite CLI (gogcli) skill?

Run npx skillmds@latest add composiohq/google-suite-cli-gogcli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Google Suite CLI (gogcli) safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Google Suite CLI (gogcli)?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Google Suite CLI (gogcli) free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Google Suite CLI (gogcli)?

Composio HQ (@composiohq) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Google Suite CLI (gogcli) by composiohq

Name: Google Suite CLI (gogcli)
Author: Composio HQ

Google Suite CLI (gogcli)

CLI for Gmail, Calendar, Chat, Drive, Docs, Sheets, Slides, Forms, Contacts, Tasks, Keep, and Admin. Use when an agent needs to interact with any Google Workspace service — send emails, manage calendar events, search Drive, read/write spreadsheets, or manage contacts.

Composio HQ a3eb5c9 3.4 KB Updated Sep 17, 2026 66.9k repo stars

File contents

gogcli — Google in your terminal

Fast, script-friendly CLI for Gmail, Calendar, Chat, Classroom, Drive, Docs, Slides, Sheets, Forms, Apps Script, Contacts, Tasks, People, Admin, Groups, and Keep.

Repo: https://github.com/steipete/gogcli
Author: @steipete

Installation

brew install gogcli

Or build from source:

git clone https://github.com/steipete/gogcli.git
cd gogcli && make

Authentication

Requires OAuth2 credentials from Google Cloud Console:

# Store OAuth client credentials (one-time)
gog auth credentials ~/Downloads/client_secret_....json

# Authorize an account
gog auth add you@gmail.com

# Set default account
export GOG_ACCOUNT=you@gmail.com

# Verify
gog gmail labels list

For headless/CI environments, use --manual or --remote auth flows, or pass --access-token directly.

Key Commands

Gmail

gog gmail search "from:boss subject:urgent"
gog gmail search "is:unread" --max 10 --json
gog gmail send --to recipient@example.com --subject "Hello" --body "Message body"
gog gmail send --to recipient@example.com --subject "Report" --attach report.pdf
gog gmail labels list
gog gmail drafts list

Calendar

gog calendar list                          # today's events
gog calendar list --days 7 --json          # next 7 days, JSON output
gog calendar create --title "Meeting" --start "2025-01-15T10:00:00" --duration 1h
gog calendar delete <eventId>
gog calendar freebusy --emails "a@co.com,b@co.com" --days 3

Drive

gog drive list
gog drive search "quarterly report"
gog drive upload ./file.pdf
gog drive download <fileId>
gog drive share <fileId> --email user@example.com --role writer

Contacts

gog contacts search "John"
gog contacts create --name "Jane Doe" --email jane@example.com --phone "+1234567890"
gog contacts update <resourceName> --title "CTO" --company "Acme"

Sheets

gog sheets read <spreadsheetId> --range "Sheet1!A1:D10" --json
gog sheets write <spreadsheetId> --range "Sheet1!A1" --values '[["Name","Score"],["Alice",95]]'
gog sheets create --title "New Sheet"

Tasks

gog tasks list
gog tasks add "Buy groceries" --due "2025-01-20"
gog tasks done <taskId>

Chat (Workspace only)

gog chat spaces list
gog chat send --space <spaceId> --message "Hello team"

Docs & Slides

gog docs create --title "Meeting Notes"
gog docs export <docId> --format markdown
gog slides create --title "Q4 Presentation"

Output Modes

Default: human-readable text
--json: structured JSON output for scripting/agents
GOG_HELP=full gog --help: full expanded command list

Multiple Accounts

gog auth add work@company.com
gog auth add personal@gmail.com
gog --account work@company.com gmail search "project update"

Agent-Friendly Features

JSON output with --json flag on all commands
Command allowlist via GOG_ALLOWED_COMMANDS for sandboxed/agent runs
Non-interactive auth flows (--manual, --remote, --access-token)
Auto-refreshing OAuth tokens
Structured exit codes

---name: google-suite-cli-gogclidescription: CLI for Gmail, Calendar, Chat, Drive, Docs, Sheets, Slides, Forms, Contacts, Tasks, Keep, and Admin. Use when an agent needs to interact with any Google Workspace service — send emails, manage calendar events, search Drive, read/write spreadsheets, or manage contacts.---# gogcli — Google in your terminalFast, script-friendly CLI for Gmail, Calendar, Chat, Classroom, Drive, Docs, Slides, Sheets, Forms, Apps Script, Contacts, Tasks, People, Admin, Groups, and Keep.- **Repo**: https://github.com/steipete/gogcli- **Author**: [@steipete](https://github.com/steipete)## Installation```bashbrew install gogcli```Or build from source:```bashgit clone https://github.com/steipete/gogcli.gitcd gogcli && make```## AuthenticationRequires OAuth2 credentials from Google Cloud Console:```bash# Store OAuth client credentials (one-time)gog auth credentials ~/Downloads/client_secret_....json# Authorize an accountgog auth add you@gmail.com# Set default accountexport GOG_ACCOUNT=you@gmail.com# Verifygog gmail labels list```For headless/CI environments, use `--manual` or `--remote` auth flows, or pass `--access-token` directly.## Key Commands### Gmail```bashgog gmail search "from:boss subject:urgent"gog gmail search "is:unread" --max 10 --jsongog gmail send --to recipient@example.com --subject "Hello" --body "Message body"gog gmail send --to recipient@example.com --subject "Report" --attach report.pdfgog gmail labels listgog gmail drafts list```### Calendar```bashgog calendar list # today's eventsgog calendar list --days 7 --json # next 7 days, JSON outputgog calendar create --title "Meeting" --start "2025-01-15T10:00:00" --duration 1hgog calendar delete <eventId>gog calendar freebusy --emails "a@co.com,b@co.com" --days 3```### Drive```bashgog drive listgog drive search "quarterly report"gog drive upload ./file.pdfgog drive download <fileId>gog drive share <fileId> --email user@example.com --role writer```### Contacts```bashgog contacts search "John"gog contacts create --name "Jane Doe" --email jane@example.com --phone "+1234567890"gog contacts update <resourceName> --title "CTO" --company "Acme"```### Sheets```bashgog sheets read <spreadsheetId> --range "Sheet1!A1:D10" --jsongog sheets write <spreadsheetId> --range "Sheet1!A1" --values '[["Name","Score"],["Alice",95]]'gog sheets create --title "New Sheet"```### Tasks```bashgog tasks listgog tasks add "Buy groceries" --due "2025-01-20"gog tasks done <taskId>```### Chat (Workspace only)```bashgog chat spaces listgog chat send --space <spaceId> --message "Hello team"```### Docs & Slides```bashgog docs create --title "Meeting Notes"gog docs export <docId> --format markdowngog slides create --title "Q4 Presentation"```## Output Modes- Default: human-readable text- `--json`: structured JSON output for scripting/agents- `GOG_HELP=full gog --help`: full expanded command list## Multiple Accounts```bashgog auth add work@company.comgog auth add personal@gmail.comgog --account work@company.com gmail search "project update"```## Agent-Friendly Features- JSON output with `--json` flag on all commands- Command allowlist via `GOG_ALLOWED_COMMANDS` for sandboxed/agent runs- Non-interactive auth flows (`--manual`, `--remote`, `--access-token`)- Auto-refreshing OAuth tokens- Structured exit codes

Frequently asked questions