mcpField
G
gcal

gcal

github.com/naoterumakerProductivity468 installsUpdated 37w ago
Repository

About gcal

gcal is a skill guide for operating Google Calendar through the gog CLI. It documents commands for managing events, calendars, availability, invitations, and access controls.

Key features

  1. 01List, search, create, update, and delete events
  2. 02Set recurring, all-day, and special events
  3. 03Check free-busy periods and scheduling conflicts
  4. 04Manage calendar lists, colors, and access controls
  5. 05Respond to invitations and configure meeting options

Use cases

  1. 01Reviewing a day's or date range's events
  2. 02Scheduling meetings with attendees and Google Meet
  3. 03Checking availability across calendars
  4. 04Managing invitations and calendar access

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/naoterumaker/openclaw-gog-skills --skill gcal

After installing, type/gcalin Claude Code to confirm it loaded.

Details

From the project README

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-meetGoogle 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 は終了日の翌日を指定
  • 参加者通知: デフォルトで招待メールが送信される
  • 繰り返し削除: 単発だけ削除するか全部削除するか確認される

Comments

Markdown supported