gog-cli 命令行工具：快速管理 Google Workspace 服务的脚本友好工具

gog-cli by intellectronica/agent-skills

217 周安装量

228 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/intellectronica/agent-skills --skill gog-cli

自动化云服务命令行工具

🇨🇳中文介绍

gogcli (gog) 命令行界面

一个快速、对脚本友好的 Google Workspace 服务命令行界面，支持 JSON 优先输出和多账户。

仓库 : https://github.com/steipete/gogcli

前提条件

此技能假定 gog 已安装并授权。如果命令因身份验证错误而失败，请告知用户他们需要：

安装 gog : brew install steipete/tap/gogcli
存储 OAuth 凭据 : gog auth credentials <path-to-credentials.json>
添加账户 : gog auth add user@gmail.com --services all

不要尝试自动解决身份验证问题。向用户提供相关命令，让他们自行处理。

支持的服务

Gmail、Calendar、Drive、Docs、Sheets、Slides、Chat (Workspace)、Classroom、Contacts、Tasks、People、Groups (Workspace)、Keep (Workspace，仅服务账户)。

快速参考

全局标志

--account <email>    # 选择账户
--client <name>      # 选择 OAuth 客户端
--json               # JSON 输出
--plain              # TSV 输出（用于脚本）
--force              # 跳过确认
--no-input           # 失败而非提示

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

Drive、Docs、Sheets、Slides

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 user@example.com --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

完整的 Drive/Docs/Sheets/Slides 参考，请参阅 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 "john@example.com"
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

关于 Classroom、Chat、Contacts、Tasks、People、Groups、Keep，请参阅 references/other-services.md。

macOS : ~/Library/Application Support/gogcli/config.json
Linux : ~/.config/gogcli/config.json
Windows : %AppData%\gogcli\config.json

gog config set default_timezone America/New_York
gog config set default_account user@gmail.com
gog config list

GOG_ACCOUNT=user@gmail.com      # 默认账户
GOG_CLIENT=work                 # OAuth 客户端
GOG_JSON=1                      # 默认 JSON 输出
GOG_PLAIN=1                     # 默认纯文本输出
GOG_TIMEZONE=America/New_York   # 显示时区
GOG_ENABLE_COMMANDS=calendar,tasks  # 命令允许列表

完整配置，请参阅 references/configuration.md。

gog --account work@example.com gmail search "is:unread"
gog auth alias set work work@example.com
gog --account work gmail search "is:unread"
gog auth list --check

关于身份验证（包括服务账户），请参阅 references/authentication.md。

# JSON 处理
gog gmail search "is:unread" --json | jq -r '.threads[].id'

# 批量操作
gog gmail search "older_than:30d" --json | \
  jq -r '.threads[].id' | \
  xargs -I {} gog gmail thread modify {} --add Archive --remove INBOX

# 非交互式
gog gmail send --to user@example.com --subject "Test" --body "Hi" --force

如果命令失败，请告知用户可能的原因：

错误	原因	解决方案
`no credentials`	OAuth 未配置	`gog auth credentials <file>`
`token expired`	身份验证无效	`gog auth add <email> --force-consent`
`insufficient scope`	缺少权限	`gog auth add <email> --services <services>`
`command not found`	未安装	`brew install steipete/tap/gogcli`

gog auth list --check
gog auth status

references/command-reference.md - 完整的命令规范
references/authentication.md - 身份验证、凭据、多账户
references/configuration.md - 配置和环境变量
references/gmail.md - Gmail 操作
references/calendar.md - 日历操作
references/drive-docs.md - Drive、Docs、Sheets、Slides
references/other-services.md - Classroom、Chat、Contacts、Tasks、People、Groups、Keep

🇺🇸English

gogcli (gog) CLI

A fast, script-friendly CLI for Google Workspace services with JSON-first output and multi-account support.

Repository : https://github.com/steipete/gogcli

Prerequisites

This skill assumes gog is installed and authorised. If commands fail with authentication errors, inform the user they need to:

Install gog : brew install steipete/tap/gogcli
Store OAuth credentials : gog auth credentials <path-to-credentials.json>
Add account : gog auth add user@gmail.com --services all

Do not attempt to resolve authentication issues automatically. Provide the user with the relevant command and let them handle it.

Supported Services

Gmail, Calendar, Drive, Docs, Sheets, Slides, Chat (Workspace), Classroom, Contacts, Tasks, People, Groups (Workspace), Keep (Workspace, service account only).

Quick Reference

Global Flags

--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

Common Patterns

gog --account work@example.com 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

Gmail

Search and Read

gog gmail search "is:unread from:boss@example.com newer_than:7d"
gog gmail messages search "is:unread" --include-body
gog gmail thread get <threadId>
gog gmail get <messageId> --format full

Send Email

# Basic send
gog gmail send --to user@example.com --subject "Hello" --body "Message"

# With HTML and attachments
gog gmail send --to user@example.com --subject "Report" \
  --body-html "<h1>Report</h1>" --attach ~/report.pdf

# Reply
gog gmail send --to user@example.com --subject "Re: Original" \
  --body "Reply" --reply-to-message-id <messageId>

Labels

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.

Calendar

Events

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 "alice@example.com,bob@example.com" \
  --rrule "FREQ=WEEKLY;BYDAY=MO,WE,FR"

# Respond
gog calendar respond primary <eventId> --status accepted

Special Event Types

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.

Drive, Docs, Sheets, Slides

Drive

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 user@example.com --role writer

Sheets

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"

Export

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.

Tasks

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>

Contacts

gog contacts search "john"
gog contacts create --given "John" --family "Doe" --email "john@example.com"
gog contacts directory search "smith"  # Workspace

Classroom

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.

Configuration

Config Locations

macOS : ~/Library/Application Support/gogcli/config.json
Linux : ~/.config/gogcli/config.json
Windows : %AppData%\gogcli\config.json

Settings

gog config set default_timezone America/New_York
gog config set default_account user@gmail.com
gog config list

Environment Variables

GOG_ACCOUNT=user@gmail.com      # 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.

Multi-Account Usage

gog --account work@example.com gmail search "is:unread"
gog auth alias set work work@example.com
gog --account work gmail search "is:unread"
gog auth list --check

For authentication including service accounts, see references/authentication.md.

Scripting

# 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 user@example.com --subject "Test" --body "Hi" --force

Troubleshooting

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>`

Status checks:

gog auth list --check
gog auth status

Reference Files

references/command-reference.md - Complete command specification
references/authentication.md - Auth, credentials, multi-account
references/configuration.md - Config and environment variables
references/gmail.md - Gmail operations
references/calendar.md - Calendar operations
references/drive-docs.md - Drive, Docs, Sheets, Slides
references/other-services.md - Classroom, Chat, Contacts, Tasks, People, Groups, Keep

Weekly Installs

217

Repository

intellectronica…t-skills

GitHub Stars

228

First Seen

Jan 29, 2026

Security Audits

Gen Agent Trust HubFail SocketPass SnykWarn

Installed on

codex188

opencode185

gemini-cli180

cursor174

github-copilot170

amp158

Azure 升级评估与自动化工具 - 轻松迁移 Functions 计划、托管层级和 SKU

73,200 周安装

gog-cli 命令行工具：快速管理 Google Workspace 服务的脚本友好工具

🇨🇳中文介绍

gogcli (gog) 命令行界面

前提条件

支持的服务

快速参考

全局标志

相关 Skills

常用模式

Gmail

搜索和阅读

发送邮件

标签

日历

事件

特殊事件类型

Drive、Docs、Sheets、Slides

Drive

Sheets

导出

任务

联系人

Classroom

配置

配置文件位置

设置

环境变量

多账户使用

脚本编写

故障排除

参考文件

🇺🇸English

gogcli (gog) CLI

Prerequisites

Supported Services

Quick Reference

Global Flags

Common Patterns

Gmail

Search and Read

Send Email

Labels

Calendar

Events

Special Event Types

Drive, Docs, Sheets, Slides

Drive

Sheets

Export

Tasks

Contacts

Classroom

Configuration

Config Locations

Settings

Environment Variables

Multi-Account Usage

Scripting

Troubleshooting

Reference Files

最新 Skills