Gog
Let your coding agent search, send, and manage Gmail, Calendar, Drive, Sheets, Docs, contacts, and tasks through the authenticated gog CLI instead of manual console work.
Overview
gog is an agent skill most often used in Build (also Operate, Grow) that runs the Google Workspace gog CLI for Gmail, Calendar, Drive, Sheets, Docs, Contacts, and Tasks.
Install
npx skills add https://github.com/naoterumaker/openclaw-gog-skills --skill gogWhat is this skill?
- Gmail search, get, attachment download, send, reply, and reply-all via `gog gmail` with query syntax (unread, labels, da
- Documented exec guidance: 60s timeout for API calls and `--max` limits for long list fetches.
- Triggers on natural requests to send mail, show calendar, upload to Drive, create spreadsheets, search contacts, and add
- Runs against a pre-authenticated default Google account configured in SKILL.md.
- v0.10.0 Google Workspace CLI surface: Gmail plus Calendar, Drive, Sheets, Docs, Contacts, Tasks referenced in the skill
- 60-second exec timeout recommended
- gog v0.10.0
Adoption & trust: 580 installs on skills.sh; 3 GitHub stars; 1/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need Google Workspace actions from your agent but only have ad-hoc API knowledge or manual UI steps.
Who is it for?
Solo builders who already authenticated gog and want repeatable Gmail-and-Workspace automation from Claude Code, Cursor, or Codex.
Skip if: Teams without Google OAuth set up, air-gapped environments, or anyone who needs Microsoft 365 or non-Google suites—use a different integration skill.
When should I use this skill?
User asks to send mail, show calendar, upload to Drive, create spreadsheets, search contacts, add tasks, or similar Google Workspace actions (JP/EN triggers in SKILL.md).
What do I get? / Deliverables
Your agent issues correct `gog` commands for search, read, send, upload, and task operations using documented flags, timeouts, and list limits.
- Executed gog CLI commands
- Sent or retrieved Gmail messages
- Workspace file or calendar operations per user request
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Canonical shelf is Build → integrations because the skill is a Google Workspace API/CLI bridge your agent invokes while assembling automations and ops workflows. Integrations is the right subphase: every command pattern wires external Google services into agent-driven product and personal workflows.
Where it fits
Wire a deploy notification email by having the agent call `gog gmail send` with CC and attachment flags.
Upload launch assets to Drive and create a tracking spreadsheet via gog Drive/Sheets commands.
How it compares
Procedural CLI integration skill, not an MCP server or browser-only Google automation.
Common Questions / FAQ
Who is gog for?
Indie builders and operators who use a coding agent daily and want Google Workspace controlled through the local gog CLI after one-time account auth.
When should I use gog?
Use it during Build when wiring automations, during Operate when triaging support or founder inbox mail, and during Grow when scheduling or moving content files—whenever you say send mail, show calendar, upload to Drive, create a sheet, search contacts, or add tasks.
Is gog safe to install?
It instructs the agent to run shell commands against your Google account and network; review the Security Audits panel on this Prism page and restrict OAuth scopes before enabling in production repos.
SKILL.md
READMESKILL.md - Gog
# gog - Google Workspace CLI (v0.10.0) Google サービスを操作するCLIツール。 **アカウント:** your-account@gmail.com (default) **実行パス:** `gog` ## Execution Notes - `exec` ツールで実行時、`timeout: 60` を指定（API応答待ちのため） - 長いリスト取得は `--max` で制限 --- ## Gmail ### メール検索 ```bash # 基本検索 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` - ラベル ### メール取得 ```bash # メッセージ取得 gog gmail get <messageId> gog gmail get <messageId> --body # 本文込み # 添付ファイルダウンロード gog gmail attachment <messageId> <attachmentId> ``` ### メール送信 ```bash # 基本送信 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` | 全員に返信 | ### ラベル操作 ```bash # ラベル一覧 gog gmail labels list # ラベル追加/削除 gog gmail thread modify <threadId> --add-labels "INBOX" --remove-labels "UNREAD" ``` --- ## Calendar ### 予定一覧 ```bash # 今後の予定（デフォルト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" ``` ### 予定作成 ```bash # 通常の予定 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` | 繰り返し | ### 予定更新・削除 ```bash # 更新 gog calendar update primary <eventId> --summary "新タイトル" # 削除 gog calendar delete primary <eventId> ``` ### 検索 ```bash gog calendar search "ミーティング" ``` ### カレンダー一覧 ```bash gog calendar calendars ``` --- ## Drive ### ファイル一覧 ```bash # ルートフォルダ gog drive ls # 特定フォルダ gog drive ls --parent <folderId> # 件数制限 gog drive ls --max 20 ``` ### 検索 ```bash gog drive search "レポート" gog drive search "mimeType='application/pdf'" ``` ### ダウンロード・アップロード ```bash # ダウンロード 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> ``` ### フォルダ作成・移動