---
title: "gog CLI"
type: entity
tags: [google-workspace, cli, macos]
last_updated: 2026-03-15
---

# gog CLI

## Overview
gog CLI（gogcli）是由 steipete 开发的 Google Workspace 命令行管理工具，通过 Homebrew 安装（`brew install steipete/tap/gogcli`），输出路径为 `/opt/homebrew/bin/gog`。支持 Gmail、Google Calendar、Google Drive、Google Contacts、Google Docs、Google Sheets 全套服务的管理。

## Aliases
- gogcli
- gog CLI
- Gog CLI

## Details

| 属性 | 值 |
|------|-----|
| 类型 | 产品 / 工具 |
| 作者 | steipete |
| GitHub | github.com/steipete/gogcli |
| 官网 | gogcli.sh |
| 平台 | macOS（Homebrew） |
| 认证方式 | OAuth 2.0 |

## Supported Services
- **Gmail**：搜索、发送、创建草稿
- **Google Calendar**：查看事件、创建事件
- **Google Drive**：搜索文件
- **Google Contacts**：列出联系人
- **Google Sheets**：获取/更新数据
- **Google Docs**：导出文档、查看内容

## Key Dependencies
- **OAuth 凭证**：需要从 Google Cloud Console 下载 `credentials.json` 并放置到 `~/Library/Application Support/gogcli/credentials.json`
- **Google Cloud Console**：用于创建 OAuth 客户端 ID 和启用各 API 服务
- **测试用户白名单**：首次授权需要将 Google 账号邮箱添加到 OAuth 客户端的测试用户列表

## Related Entities
- [[Google]] — Google 公司
- [[personal-crm]] — 使用 gog CLI 提供 Gmail 和 Calendar 数据
- [[multi-channel-assistant]] — 整合 Google Workspace（gog）

## Related Sources
- [[gog-cli-安装配置指南]] — 完整安装与配置指南