Gmail 操作スキル (gog v0.10.0)

gog CLI でGmailを操作する。

実行パス: gog

認証アカウント: (gogで認証したアカウント)

Execution Notes

exec ツールで実行時、timeout: 60 を指定
大量検索は --max で制限

メール検索

基本検索

gog gmail search "<query>"
gog gmail search "is:unread" --max 10
gog gmail search "from:someone@example.com"

検索クエリ一覧

クエリ	説明
`is:unread`	未読
`is:starred`	スター付き
`is:important`	重要
`from:xxx`	送信者
`to:xxx`	宛先
`cc:xxx`	CC
`subject:xxx`	件名に含む
`"キーワード"`	完全一致検索
`has:attachment`	添付ファイルあり
`filename:pdf`	PDFファイル添付
`larger:5M`	5MB以上
`smaller:1M`	1MB以下
`after:YYYY/MM/DD`	指定日以降
`before:YYYY/MM/DD`	指定日以前
`older_than:7d`	7日より前
`newer_than:3d`	3日以内
`label:xxx`	特定ラベル
`in:inbox`	受信トレイ
`in:sent`	送信済み
`in:trash`	ゴミ箱
`in:anywhere`	すべて（ゴミ箱含む）

複合検索例

# 田中さんから今週届いた未読メール
gog gmail search "from:tanaka is:unread newer_than:7d"

# 請求書関連の添付ファイル付きメール
gog gmail search "subject:請求書 has:attachment"

# 2026年1月以降のPDF添付メール
gog gmail search "filename:pdf after:2026/01/01"

メール取得

スレッド・メッセージ取得

# メッセージ詳細（本文込み）
gog gmail get <messageId>

# メタデータのみ
gog gmail messages get <messageId> --format metadata

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

gog gmail attachment <messageId> <attachmentId>
gog gmail attachment <messageId> <attachmentId> --output "./download.pdf"

メール送信

基本送信

gog gmail send \
  --to "recipient@example.com" \
  --subject "件名" \
  --body "本文テキスト"

CC/BCC付き

gog gmail send \
  --to "main@example.com" \
  --cc "copy1@example.com,copy2@example.com" \
  --bcc "hidden@example.com" \
  --subject "件名" \
  --body "本文"

添付ファイル付き

gog gmail send \
  --to "recipient@example.com" \
  --subject "資料送付" \
  --body "添付ファイルをご確認ください。" \
  --attach "./report.pdf" \
  --attach "./data.xlsx"

HTML本文

gog gmail send \
  --to "recipient@example.com" \
  --subject "HTMLメール" \
  --body-html "<h1>見出し</h1><p>本文です。</p>"

ファイルから本文読み込み

gog gmail send \
  --to "recipient@example.com" \
  --subject "長文メール" \
  --body-file "./email_body.txt"

返信

スレッドに返信

gog gmail send \
  --thread-id "<threadId>" \
  --to "original-sender@example.com" \
  --subject "Re: 元の件名" \
  --body "返信本文"

メッセージに直接返信

gog gmail send \
  --reply-to-message-id "<messageId>" \
  --to "original-sender@example.com" \
  --subject "Re: 元の件名" \
  --body "返信本文"

全員に返信

gog gmail send \
  --reply-to-message-id "<messageId>" \
  --reply-all \
  --subject "Re: 元の件名" \
  --body "全員への返信"

ラベル操作

ラベル一覧

gog gmail labels list

ラベル追加/削除

# ラベル追加
gog gmail thread modify <threadId> --add-labels "重要"

# ラベル削除
gog gmail thread modify <threadId> --remove-labels "UNREAD"

# 既読にする
gog gmail thread modify <threadId> --remove-labels "UNREAD"

# アーカイブ
gog gmail thread modify <threadId> --remove-labels "INBOX"

送信オプション一覧

オプション	説明
`--to`	宛先（必須、カンマ区切りで複数可）
`--cc`	CC（カンマ区切り）
`--bcc`	BCC（カンマ区切り）
`--subject`	件名（必須）
`--body`	本文（プレーンテキスト）
`--body-html`	HTML本文
`--body-file`	本文ファイル（`-` でstdin）
`--attach`	添付ファイル（複数指定可）
`--thread-id`	返信先スレッドID
`--reply-to-message-id`	返信先メッセージID
`--reply-all`	全員に返信
`--from`	送信元アドレス（送信エイリアス）
`--reply-to`	Reply-Toヘッダー

出力オプション

オプション	説明
`--json`	JSON出力
`--plain`	TSV出力
`--max N`	最大N件
`--all`	全ページ取得

典型ワークフロー

未読メール確認→返信

# 1. 未読検索
gog gmail search "is:unread" --max 5 --json

# 2. 詳細確認
gog gmail get <messageId>

# 3. 返信
gog gmail send \
  --reply-to-message-id "<messageId>" \
  --to "sender@example.com" \
  --subject "Re: 件名" \
  --body "ご連絡ありがとうございます。..."

添付ファイル検索→ダウンロード

# 1. 検索
gog gmail search "from:client has:attachment" --json

# 2. メッセージ取得（添付ID確認）
gog gmail get <messageId> --json

# 3. ダウンロード
gog gmail attachment <messageId> <attachmentId> --output "./downloaded.pdf"

メッセージ一覧

gog gmail messages                      # 受信メッセージ一覧
gog gmail messages --max 20 --json

スレッド操作

# スレッド取得（スレッド内の全メッセージ）
gog gmail thread <threadId>
gog gmail thread <threadId> --json

# スレッドのラベル変更
gog gmail thread modify <threadId> --add-labels "重要"
gog gmail thread modify <threadId> --remove-labels "UNREAD"

下書き操作

# 下書き一覧
gog gmail drafts list
gog gmail drafts list --json

# 下書き作成
gog gmail drafts create \
  --to "recipient@example.com" \
  --subject "件名" \
  --body "本文"

# 下書き送信
gog gmail drafts send <draftId>

# 下書き削除
gog gmail drafts delete <draftId>

トップレベル send コマンド

gog send はメール送信のショートカット:

gog send --to "recipient@example.com" --subject "件名" --body "本文"

gog gmail send と同等。

注意事項

長い本文: --body-file を使う
特殊文字: シェルエスケープに注意
大量送信: レート制限に注意
返信時: 件名に「Re: 」をつける