Google Workspace（gogcli）

gogcli CLIで Gmail / Google Drive / Google Calendar を操作する。複数アカウント対応。

絶対遵守事項

• メール送信・ファイル削除など外部に影響する操作は必ず確認してから実行
• メール本文にプライベートな情報が含まれる場合、グループチャットには流さない

環境設定

export PATH="$HOME/bin:$PATH"
export GOG_KEYRING_PASSWORD=<your-password>

全コマンドの先頭にこの2行が必要。パスワードは環境に合わせて設定。

登録済みアカウント

gog auth list

Gmail

メールチェック（全アカウント一括）

全アカウントの未読メールを確認し、重要なものをピックアップして報告。

gog -a <email> gmail search "is:unread" --max 10

メール検索

gog -a <email> gmail search "<Gmailの検索クエリ>" --max 20

検索クエリ例:

• is:unread — 未読
• from:someone@example.com — 特定の送信者
• subject:会議 — 件名に「会議」
• newer_than:7d — 7日以内
• has:attachment — 添付あり

メール本文を読む

gog -a <email> gmail read <messageId>

メール送信（確認必須）

gog -a <email> gmail send --to "recipient@example.com" --subject "件名" --body "本文"

その他

gog -a <email> gmail archive <messageId>      # アーカイブ
gog -a <email> gmail mark-read <messageId>     # 既読にする
gog -a <email> gmail labels list               # ラベル一覧

Google Drive

ファイル一覧・検索

gog -a <email> drive list                              # ルート一覧
gog -a <email> drive list --query "name contains 'xxx'" # 検索
gog -a <email> drive list --folder <folderId>           # フォルダ内

ファイルダウンロード

gog -a <email> drive download <fileId> -o /path/to/output

ファイルアップロード（確認必須）

gog -a <email> drive upload /path/to/file --folder <folderId>

Google Calendar

予定確認

gog -a <email> calendar list                    # 今日の予定（primaryのみ）
gog -a <email> calendar list --days 7           # 1週間の予定
gog -a <email> calendar list --all --days 7     # 全カレンダー（ファミリー含む）

注意: デフォルトはprimaryカレンダーのみ。ファミリーカレンダー等を含めるには --all を付ける。

アカウント追加

新しいアカウントを追加する場合:

# ヘッドレス環境: remoteフローで認証
GOG_KEYRING_PASSWORD=<password> gog auth add <email> --services gmail,drive,calendar --remote --step 1
# → URLをユーザーに送る → ブラウザで認証 → リダイレクトURLを受け取る
GOG_KEYRING_PASSWORD=<password> gog auth add <email> --services gmail,drive,calendar --remote --step 2 --auth-url "<リダイレクトURL>"

# ブラウザがある環境: 直接認証
GOG_KEYRING_PASSWORD=<password> gog auth add <email> --services gmail,drive,calendar

※Google Cloud Consoleのテストユーザーに追加が必要。

対話フロー

「メールチェックして」

1. 全登録アカウントの未読メールを取得
2. ニュースレター・通知系・プロモーションなど重要度の低いメールは自動スキップ
3. 重要なメールをアカウントごとにハイライトして報告

「〇〇のメール読んで」

1. 検索クエリで該当メールを特定
2. gmail read で本文取得
3. 要約して報告

「Driveにファイルアップロードして」

1. ファイルパスとアップロード先を確認
2. 確認後に実行

使用例

メールチェックして
未読メール見せて
Zennからのメール探して
Driveのファイル一覧
今週の予定確認