gcontacts

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が必要
• 重複: 同名の連絡先は複数作成可能
• 同期: 変更は即時反映
• 削除: 完全削除（ゴミ箱なし）