Gcontacts
- 624 installs
- 3 repo stars
- Updated February 16, 2026
- naoterumaker/openclaw-gog-skills
gcontacts is a Claude Code skill that runs gog CLI v0.10.0 commands to search, create, update, and delete Google Contacts for developers who need address-book automation from natural-language prompts.
About
gcontacts is a Google Contacts operations skill built on the gog CLI (v0.10.0). It maps natural-language requests—contact search, phone lookup, list, add, update, or delete—to concrete shell commands such as gog contacts search, gog contacts list --json, and gog contacts get with a 60-second exec timeout. Developers reach for gcontacts when a coding agent must query an authenticated Google account's address book, filter results with --max limits, or mutate contacts without opening the Google UI. Execution requires a prior gog-authenticated account and the gog binary on PATH.
- Full CRUD operations on Google Contacts via gog CLI (v0.10.0)
- Supports search by name, email, or phone with optional --max limit
- Create contacts with multiple emails and phone numbers in one command
- Update and delete contacts using resourceName identifiers
- Directory (organizational) contact listing support
Gcontacts by the numbers
- 624 all-time installs (skills.sh)
- Ranked #619 of 4,347 Backend & APIs skills by installs in the Skillselion catalog
- Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/naoterumaker/openclaw-gog-skills --skill gcontactsAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 624 |
|---|---|
| repo stars | ★ 3 |
| Last updated | February 16, 2026 |
| Repository | naoterumaker/openclaw-gog-skills ↗ |
How do you search Google Contacts from a CLI?
Let their coding agent search, create, update, and delete Google Contacts directly from natural language prompts.
Who is it for?
Developers whose agent workflows need programmatic Google Contacts lookup and CRUD through the gog CLI.
Skip if: Teams without gog CLI authentication or projects that only need Gmail, Calendar, or non-Google CRM integrations.
When should I use this skill?
A user asks to search contacts by name, email, or phone, list address-book entries, or add or update a Google Contact.
What you get
Filtered contact search results, JSON contact lists, and created or updated Google Contact records via gog resourceName identifiers.
- Contact search results
- JSON contact lists
- Updated Google Contact records
By the numbers
- Built for gog CLI v0.10.0
- Documents exec timeout of 60 seconds for contact commands
Files
Google Contacts 操作スキル (gog v0.10.0)
gog CLI でGoogle連絡先を操作する。
実行パス: gog
認証アカウント: (gogで認証したアカウント)
Execution Notes
execツールで実行時、timeout: 60を指定
---
連絡先検索
名前・メール・電話で検索
gog contacts search "田中"
gog contacts search "tanaka@example.com"
gog contacts search "090-1234"検索結果を絞り込み
gog contacts search "山田" --max 10---
連絡先一覧
gog contacts list
gog contacts list --max 50
gog contacts list --json---
連絡先詳細
gog contacts get <resourceName>
# resourceNameは "people/c12345678" のような形式---
連絡先作成
基本
gog contacts create --name "山田太郎"フル情報
gog contacts create \
--name "山田太郎" \
--email "yamada@example.com" \
--phone "090-1234-5678"複数メール・電話
gog contacts create \
--name "佐藤花子" \
--email "sato@company.com" \
--email "sato.personal@example.com" \
--phone "090-1111-2222" \
--phone "03-1234-5678"---
連絡先更新
gog contacts update <resourceName> --name "新しい名前"
gog contacts update <resourceName> --email "new@example.com"
gog contacts update <resourceName> --phone "080-9999-8888"---
連絡先削除
gog contacts delete <resourceName>
gog contacts delete <resourceName> --force # 確認スキップ---
ディレクトリ連絡先（組織の連絡先）
# 組織ディレクトリの一覧
gog contacts directory list
# ディレクトリ検索
gog contacts directory search "部署名"---
その他の連絡先
# その他の連絡先一覧
gog contacts other list---
作成オプション一覧
| オプション | 説明 |
|---|---|
--name | 名前 |
--email | メールアドレス（複数可） |
--phone | 電話番号（複数可） |
--organization | 会社名 |
--title | 役職 |
--note | メモ |
---
出力オプション
| オプション | 説明 |
|---|---|
--json | JSON出力 |
--plain | TSV出力 |
--max N | 最大N件 |
---
resourceName について
連絡先のIDは resourceName 形式:
people/c12345678901234567890
list や search の結果から取得できる。
---
典型ワークフロー
連絡先検索→情報取得
# 1. 検索
gog contacts search "田中" --json
# 2. 詳細取得
gog contacts get "people/c1234567890"新規連絡先作成
gog contacts create \
--name "新規顧客 株式会社ABC" \
--email "contact@abc-corp.com" \
--phone "03-1234-5678" \
--organization "株式会社ABC" \
--title "営業部長" \
--note "2026年2月商談開始"連絡先更新
# 電話番号変更
gog contacts update "people/c1234567890" --phone "080-新番号"---
注意事項
- resourceName: 操作には正確なresourceNameが必要
- 重複: 同名の連絡先は複数作成可能
- 同期: 変更は即時反映
- 削除: 完全削除（ゴミ箱なし）
Related skills
Lark Openapi ExplorerInstantly explore, test, and generate calls against the full Lark (Feishu) OpenAPI surface without leaving their agent workflow.493k
Lark EventConsume real-time events from Lark/Feishu as structured NDJSON streams inside AI agent workflows.387k16kLark Openapi ExplorerWhen an existing Lark/Feishu skill or CLI command cannot fulfill a specific requirement and they need to discover and invoke the exact native OpenAPI endpoint.386k16k
Just ScrapeQuickly search, crawl, extract structured JSON, or monitor web pages without writing custom scraping code.245k41Lark AppsQuery the current visibility and permission scope of a Lark (Feishu) app without writing HTTP client code.235k16k
Design An InterfaceGenerate multiple radically different interface or API designs in parallel before committing to one.188k198kFAQ
What CLI does gcontacts use for Google Contacts?
gcontacts executes the gog CLI at version 0.10.0, calling subcommands like gog contacts search, gog contacts list --json, and gog contacts get with Google resourceName identifiers.
How does gcontacts limit long-running contact queries?
gcontacts instructs agents to run gog commands through exec with timeout set to 60 seconds, preventing hung contact searches or large list operations from blocking the session.