gog - Google Workspace CLI (v0.10.0)

Google サービスを操作するCLIツール。

アカウント: your-account@gmail.com (default)

実行パス: gog

Execution Notes

• exec ツールで実行時、timeout: 60 を指定（API応答待ちのため）

• 長いリスト取得は --max で制限

Gmail

メール検索

# 基本検索

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

検索クエリ例:

• is:unread - 未読

• from:xxx - 送信者

• to:xxx - 宛先

• subject:xxx - 件名

• has:attachment - 添付あり

• after:YYYY/MM/DD - 日付以降

• label:xxx - ラベル

メール取得

# メッセージ取得

gog gmail get <messageId>

gog gmail get <messageId> --body  # 本文込み

# 添付ファイルダウンロード

gog gmail attachment <messageId> <attachmentId>

メール送信

# 基本送信

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 "返信"

送信オプション:

オプション

説明

--to

宛先（カンマ区切り）

--cc

CC

--bcc

BCC

--subject

件名

--body

本文（プレーンテキスト）

--body-html

HTML本文

--body-file

本文ファイル

--attach

添付ファイル（複数可）

--thread-id

スレッドID（返信時）

--reply-to-message-id

返信元メッセージID

--reply-all

全員に返信

ラベル操作

# ラベル一覧

gog gmail labels list

# ラベル追加/削除

gog gmail thread modify <threadId> --add-labels "INBOX" --remove-labels "UNREAD"

Calendar

予定一覧

# 今後の予定（デフォルト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"

予定作成

# 通常の予定

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"

作成オプション:

オプション

説明

--summary

タイトル

--from

開始時刻（RFC3339）

--to

終了時刻（RFC3339）

--all-day

終日予定

--location

場所

--description

説明

--attendees

参加者（カンマ区切り）

--with-meet

Google Meet作成

--reminder

リマインダー（popup:30m, email:1d等）

--rrule

繰り返し

予定更新・削除

# 更新

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

# 削除

gog calendar delete primary <eventId>

検索

gog calendar search "ミーティング"

カレンダー一覧

gog calendar calendars

Drive

ファイル一覧

# ルートフォルダ

gog drive ls

# 特定フォルダ

gog drive ls --parent <folderId>

# 件数制限

gog drive ls --max 20

検索

gog drive search "レポート"

gog drive search "mimeType='application/pdf'"

ダウンロード・アップロード

# ダウンロード

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>

フォルダ作成・移動

# フォルダ作成

gog drive mkdir "新フォルダ"

gog drive mkdir "サブフォルダ" --parent <parentFolderId>

# 移動

gog drive move <fileId> --parent <newFolderId>

# リネーム

gog drive rename <fileId> "新しい名前"

コピー

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

読み取り

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

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

書き込み

# パイプ区切りで複数セル

gog sheets update <spreadsheetId> "シート1!A1:C1" "値1|値2|値3"

# JSON形式（カンマ・パイプを含むデータ）

gog sheets update <spreadsheetId> "シート1!A1:C2" --values-json '[["名前","金額"],["田中","500,000"]]'

追加（末尾に行追加）

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

クリア

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

書式設定

FMT='{"backgroundColor":{"red":0.2,"green":0.4,"blue":0.7},"textFormat":{"bold":true}}'

gog sheets format <spreadsheetId> "シート1!A1:C1" --format-json "$FMT"

作成・コピー

# 新規作成

gog sheets create "新しいスプレッドシート"

gog sheets create "タイトル" --sheets "シート1,シート2,シート3"

# コピー

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

メタデータ・エクスポート

gog sheets metadata <spreadsheetId>

gog sheets export <spreadsheetId> --format csv

gog sheets export <spreadsheetId> --format xlsx

Contacts

検索・一覧

gog contacts list

gog contacts list --max 50

gog contacts search "田中"

取得・作成

gog contacts get <resourceName>

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

更新・削除

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

gog contacts delete <resourceName>

Tasks

タスクリスト

gog tasks lists list  # リスト一覧

タスク操作

# 一覧

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>

共通オプション

オプション

説明

--json

JSON出力

--plain

TSV出力

-a, --account

アカウント指定

--max

最大件数

--force

確認スキップ

-n, --dry-run

実行せずプレビュー

Tips

• SpreadsheetId: URL https://docs.google.com/spreadsheets/d/<ID>/edit から取得

• FileId: URL https://drive.google.com/file/d/<ID>/view から取得

• CalendarId: primary でメインカレンダー、または共有カレンダーのメールアドレス

• TasklistId: gog tasks lists list で確認