gog

gog - Google Workspace CLI (v0.10.0)

A CLI tool for operating Google services.

Account: your-account@gmail.com (default)

Execution path: gog

Execution Notes

exec When running with the tool,timeout: 60 specify (to wait for the API response)
For long list retrieval, --max limit with

Gmail

Email search

# 基本検索
gog gmail search "検索クエリ"
gog gmail search "from:someone@example.com"
gog gmail search "is:unread" --max 10
gog gmail search "subject:請求書 after:2026/01/01"

# 全ページ取得
gog gmail search "label:重要" --all

Search query examples:

is:unread - Unread
from:xxx - Sender
to:xxx - Recipient
subject:xxx - Subject
has:attachment - Has attachment
after:YYYY/MM/DD - Since date
label:xxx - Label

Email retrieval

# メッセージ取得
gog gmail get <messageId>
gog gmail get <messageId> --body  # 本文込み

# 添付ファイルダウンロード
gog gmail attachment <messageId> <attachmentId>

Email sending

# 基本送信
gog gmail send --to "recipient@example.com" --subject "件名" --body "本文"

# CC/BCC付き
gog gmail send --to "a@b.com" --cc "c@d.com" --bcc "e@f.com" --subject "件名" --body "本文"

# 添付ファイル付き
gog gmail send --to "a@b.com" --subject "件名" --body "本文" --attach "./file.pdf"

# スレッドに返信
gog gmail send --thread-id <threadId> --to "a@b.com" --subject "Re: 件名" --body "返信本文"

# 全員に返信
gog gmail send --reply-to-message-id <messageId> --reply-all --subject "Re: 件名" --body "返信"

Send options:

Options	Description
`--to`	Recipients (comma-separated)
`--cc`	CC
`--bcc`	BCC
`--subject`	Subject
`--body`	Body (plain text)
`--body-html`	HTML body
`--body-file`	Body file
`--attach`	Attachments (multiple allowed)
`--thread-id`	Thread ID (when replying)
`--reply-to-message-id`	Source message ID for reply
`--reply-all`	Reply all

Label operations

# ラベル一覧
gog gmail labels list

# ラベル追加/削除
gog gmail thread modify <threadId> --add-labels "INBOX" --remove-labels "UNREAD"

Calendar

Event list

# 今後の予定（デフォルト7日間）
gog calendar events
gog calendar events --max 20

# 期間指定
gog calendar events --from "2026-02-01" --to "2026-02-28"

# 特定カレンダー
gog calendar events primary
gog calendar events "user@example.com"

Event creation

# 通常の予定
gog calendar create primary --summary "ミーティング" --from "2026-02-15T10:00:00+09:00" --to "2026-02-15T11:00:00+09:00"

# 終日予定
gog calendar create primary --summary "休暇" --from "2026-02-20" --to "2026-02-21" --all-day

# 場所・参加者付き
gog calendar create primary --summary "会議" --from "2026-02-15T14:00:00+09:00" --to "2026-02-15T15:00:00+09:00" \
  --location "会議室A" --attendees "a@b.com,c@d.com"

# Google Meet付き
gog calendar create primary --summary "オンラインMTG" --from "2026-02-15T10:00:00+09:00" --to "2026-02-15T11:00:00+09:00" --with-meet

# リマインダー付き
gog calendar create primary --summary "MTG" --from "2026-02-15T10:00:00+09:00" --to "2026-02-15T11:00:00+09:00" --reminder "popup:30m" --reminder "email:1d"

Creation options:

Options	Description
`--summary`	Title
`--from`	Start time (RFC3339)
`--to`	End time (RFC3339)
`--all-day`	All-day event
`--location`	Location
`--description`	Description
`--attendees`	Attendees (comma-separated)
`--with-meet`	Create Google Meet
`--reminder`	Reminders (popup:30m, email:1d, etc.)
`--rrule`	Recurrence

Event update/delete

# 更新
gog calendar update primary <eventId> --summary "新タイトル"

# 削除
gog calendar delete primary <eventId>

Search

gog calendar search "ミーティング"

Calendar list

gog calendar calendars

Drive

File list

# ルートフォルダ
gog drive ls

# 特定フォルダ
gog drive ls --parent <folderId>

# 件数制限
gog drive ls --max 20

Search

gog drive search "レポート"
gog drive search "mimeType='application/pdf'"

Download / Upload

# ダウンロード
gog drive download <fileId>
gog drive download <fileId> --output "./local-file.pdf"

# アップロード
gog drive upload "./local-file.pdf"
gog drive upload "./file.pdf" --parent <folderId>

Folder creation/move

# フォルダ作成
gog drive mkdir "新フォルダ"
gog drive mkdir "サブフォルダ" --parent <parentFolderId>

# 移動
gog drive move <fileId> --parent <newFolderId>

# リネーム
gog drive rename <fileId> "新しい名前"

Copy

gog drive copy <fileId> "コピー名"
gog drive copy <fileId> "コピー名" --parent <folderId>

# 共有
gog drive share <fileId> --email "user@example.com" --role reader
gog drive share <fileId> --email "user@example.com" --role writer

# 権限一覧
gog drive permissions <fileId>

# 共有解除
gog drive unshare <fileId> <permissionId>

Sheets

Read

gog sheets get <spreadsheetId> "シート1!A1:C10"
gog sheets get <spreadsheetId> "シート1!A:A"  # 列全体

Write

# パイプ区切りで複数セル
gog sheets update <spreadsheetId> "シート1!A1:C1" "値1|値2|値3"

# JSON形式（カンマ・パイプを含むデータ）
gog sheets update <spreadsheetId> "シート1!A1:C2" --values-json '[["名前","金額"],["田中","500,000"]]'

Append (append rows at the end)

gog sheets append <spreadsheetId> "シート1" "値1|値2|値3"

Clear

gog sheets clear <spreadsheetId> "シート1!A1:C10"

Formatting

FMT='{"backgroundColor":{"red":0.2,"green":0.4,"blue":0.7},"textFormat":{"bold":true}}'
gog sheets format <spreadsheetId> "シート1!A1:C1" --format-json "$FMT"

Create/copy

# 新規作成
gog sheets create "新しいスプレッドシート"
gog sheets create "タイトル" --sheets "シート1,シート2,シート3"

# コピー
gog sheets copy <spreadsheetId> "コピー名"

Metadata Export

gog sheets metadata <spreadsheetId>
gog sheets export <spreadsheetId> --format csv
gog sheets export <spreadsheetId> --format xlsx

Contacts

Search/list

gog contacts list
gog contacts list --max 50
gog contacts search "田中"

Get/create

gog contacts get <resourceName>
gog contacts create --name "山田太郎" --email "yamada@example.com" --phone "090-1234-5678"

Update/delete

gog contacts update <resourceName> --name "新しい名前"
gog contacts delete <resourceName>

Tasks

Task List

gog tasks lists list  # リスト一覧

Task operations

# 一覧
gog tasks list <tasklistId>

# 作成
gog tasks add <tasklistId> --title "やること"
gog tasks add <tasklistId> --title "タスク" --notes "詳細メモ" --due "2026-02-20"

# 完了
gog tasks done <tasklistId> <taskId>

# 未完了に戻す
gog tasks undo <tasklistId> <taskId>

# 更新
gog tasks update <tasklistId> <taskId> --title "新タイトル"

# 削除
gog tasks delete <tasklistId> <taskId>

# 完了済みをクリア
gog tasks clear <tasklistId>

Common options

Options	Description
`--json`	JSON output
`--plain`	TSV output
`-a, --account`	Account specification
`--max`	Maximum count
`--force`	Skip confirmation
`-n, --dry-run`	Preview without executing

Tips

SpreadsheetId: URL https://docs.google.com/spreadsheets/d/<ID>/edit Get from
FileId: URL https://drive.google.com/file/d/<ID>/view Get from
CalendarId: primary for the main calendar, or the email address of a shared calendar
TasklistId: gog tasks lists list confirm with

About this skill

Execution Notes

Gmail

Email search

Email retrieval

Email sending

Label operations

Calendar

Event list

Event creation

Event update/delete

Search

Calendar list

Drive

File list

Search

Download / Upload

Folder creation/move

Copy

Share

Sheets

Read

Write

Append (append rows at the end)

Clear

Formatting

Create/copy

Metadata Export

Contacts

Search/list

Get/create

Update/delete

Tasks

Task List

Task operations

Common options

Tips