gcal

Google Calendar 操作スキル (gog v0.10.0)

gog CLI でGoogleカレンダーを操作する。

実行パス: gog

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

Execution Notes

• exec ツールで実行時、timeout: 60 を指定
• 日時はRFC3339形式: 2026-02-15T10:00:00+09:00

---

予定一覧

基本（今後7日間）

gog calendar events
gog calendar events --max 10

期間指定

gog calendar events --from "2026-02-01" --to "2026-02-28"
gog calendar events --from "2026-02-15T00:00:00+09:00" --to "2026-02-15T23:59:59+09:00"

特定カレンダー

gog calendar events primary                    # メインカレンダー
gog calendar events "[email protected]"         # 共有カレンダー

今日の予定

TODAY=$(date +%Y-%m-%d)
gog calendar events --from "${TODAY}T00:00:00+09:00" --to "${TODAY}T23:59:59+09:00"

---

予定作成

基本

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 "クライアントMTG" \
  --from "2026-02-15T14:00:00+09:00" \
  --to "2026-02-15T15:30:00+09:00" \
  --location "東京都渋谷区〇〇ビル 5F" \
  --description "議題:\n1. 進捗報告\n2. 次回スケジュール"

参加者追加

gog calendar create primary \
  --summary "定例会議" \
  --from "2026-02-15T10:00:00+09:00" \
  --to "2026-02-15T11:00:00+09:00" \
  --attendees "[email protected],[email protected]"

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"

繰り返し予定

# 毎週月曜
gog calendar create primary \
  --summary "週次定例" \
  --from "2026-02-17T10:00:00+09:00" \
  --to "2026-02-17T11:00:00+09:00" \
  --rrule "RRULE:FREQ=WEEKLY;BYDAY=MO"

# 毎月15日
gog calendar create primary \
  --summary "月次報告" \
  --from "2026-02-15T10:00:00+09:00" \
  --to "2026-02-15T11:00:00+09:00" \
  --rrule "RRULE:FREQ=MONTHLY;BYMONTHDAY=15"

---

予定更新

gog calendar update primary <eventId> --summary "新しいタイトル"
gog calendar update primary <eventId> --from "2026-02-15T11:00:00+09:00" --to "2026-02-15T12:00:00+09:00"
gog calendar update primary <eventId> --location "オンライン"

---

予定削除

gog calendar delete primary <eventId>
gog calendar delete primary <eventId> --force  # 確認スキップ

---

予定検索

gog calendar search "ミーティング"
gog calendar search "MTG" --from "2026-02-01" --to "2026-02-28"

---

カレンダー管理

カレンダー一覧

gog calendar calendars

空き時間確認

gog calendar freebusy "primary,[email protected]" \
  --from "2026-02-15T09:00:00+09:00" \
  --to "2026-02-15T18:00:00+09:00"

予定の衝突確認

gog calendar conflicts --from "2026-02-15" --to "2026-02-21"

---

特殊イベント

フォーカスタイム

gog calendar focus-time primary \
  --from "2026-02-15T14:00:00+09:00" \
  --to "2026-02-15T17:00:00+09:00"

外出中（Out of Office）

gog calendar out-of-office primary \
  --from "2026-02-20" \
  --to "2026-02-21"

勤務場所設定

gog calendar working-location primary \
  --from "2026-02-15" \
  --to "2026-02-16" \
  --type "home"

---

作成オプション一覧

オプション	説明
--summary	タイトル
--from	開始日時（RFC3339）
--to	終了日時（RFC3339）
--all-day	終日予定
--location	場所
--description	説明
--attendees	参加者（カンマ区切り）
--with-meet	Google Meet作成
--reminder	リマインダー（popup:30m, email:1d等）
--rrule	繰り返しルール
--event-color	色（1-11）
--visibility	公開設定（default/public/private）
--transparency	表示（opaque=予定あり/transparent=空き）
--send-updates	通知（all/externalOnly/none）
--guests-can-invite	ゲスト招待許可
--guests-can-modify	ゲスト編集許可

---

日時形式

RFC3339形式

2026-02-15T10:00:00+09:00   # 日本時間
2026-02-15T01:00:00Z        # UTC

終日イベントの日付

2026-02-15   # 開始日
2026-02-16   # 終了日（翌日を指定）

---

典型ワークフロー

今日の予定確認→ミーティング追加

# 1. 今日の予定確認
TODAY=$(date +%Y-%m-%d)
gog calendar events --from "${TODAY}T00:00:00+09:00" --to "${TODAY}T23:59:59+09:00"

# 2. 空き時間確認
gog calendar freebusy "primary" --from "${TODAY}T09:00:00+09:00" --to "${TODAY}T18:00:00+09:00"

# 3. 予定作成（Google Meet付き）
gog calendar create primary \
  --summary "緊急MTG" \
  --from "${TODAY}T15:00:00+09:00" \
  --to "${TODAY}T16:00:00+09:00" \
  --with-meet \
  --attendees "[email protected]"

来週の予定確認

START=$(date -v+1d +%Y-%m-%d)  # macOS
END=$(date -v+7d +%Y-%m-%d)
gog calendar events --from "$START" --to "$END"

---

招待への返答（RSVP）

gog calendar respond primary <eventId> --status accepted
gog calendar respond primary <eventId> --status declined
gog calendar respond primary <eventId> --status tentative

---

カレンダーの色一覧

gog calendar colors

---

単一イベント取得

gog calendar event primary <eventId>
gog calendar event primary <eventId> --json

---

アクセス制御 (ACL)

# ACL一覧
gog calendar acl primary

# ACL追加
gog calendar acl primary --add "[email protected]" --role reader

# ACL削除
gog calendar acl primary --remove "[email protected]"

---

注意事項

• タイムゾーン: +09:00 を必ず付ける（日本時間）
• 終日イベント: --to は終了日の翌日を指定
• 参加者通知: デフォルトで招待メールが送信される
• 繰り返し削除: 単発だけ削除するか全部削除するか確認される