gcontacts

Google Contacts operation skill (gog v0.10.0)

Operate Google Contacts with the gog CLI.

Execution path: gog

Authenticated account: (account authenticated with gog)

Execution Notes

• exec When executing with the tool,timeout: 60 specify

---

Contact search

Search by name, email, or phone

gog contacts search "田中"
gog contacts search "tanaka@example.com"
gog contacts search "090-1234"

Narrow down search results

gog contacts search "山田" --max 10

---

Contact list

gog contacts list
gog contacts list --max 50
gog contacts list --json

---

Contact details

gog contacts get <resourceName>

# resourceNameは "people/c12345678" のような形式

---

Create contact

Basic

gog contacts create --name "山田太郎"

Full information

gog contacts create \
  --name "山田太郎" \
  --email "yamada@example.com" \
  --phone "090-1234-5678"

Multiple emails and phones

gog contacts create \
  --name "佐藤花子" \
  --email "sato@company.com" \
  --email "sato.personal@example.com" \
  --phone "090-1111-2222" \
  --phone "03-1234-5678"

---

Update contact

gog contacts update <resourceName> --name "新しい名前"
gog contacts update <resourceName> --email "new@example.com"
gog contacts update <resourceName> --phone "080-9999-8888"

---

Delete contact

gog contacts delete <resourceName>
gog contacts delete <resourceName> --force  # 確認スキップ

---

Directory contacts (organization contacts)

# 組織ディレクトリの一覧
gog contacts directory list

# ディレクトリ検索
gog contacts directory search "部署名"

---

Other contacts

# その他の連絡先一覧
gog contacts other list

---

List of creation options

Options	Description
--name	Name
--email	Email address (multiple allowed)
--phone	Phone number (multiple allowed)
--organization	Company name
--title	Job title
--note	Notes

---

Output options

Options	Description
--json	JSON output
--plain	TSV output
--max N	Maximum N items

---

About resourceName

The contact ID is in the resourceName format:

• people/c12345678901234567890

list や search It can be obtained from the results of .

---

Typical workflow

Contact search → retrieve information

# 1. 検索
gog contacts search "田中" --json

# 2. 詳細取得
gog contacts get "people/c1234567890"

Create new contact

gog contacts create \
  --name "新規顧客 株式会社ABC" \
  --email "contact@abc-corp.com" \
  --phone "03-1234-5678" \
  --organization "株式会社ABC" \
  --title "営業部長" \
  --note "2026年2月商談開始"

Update contact

# 電話番号変更
gog contacts update "people/c1234567890" --phone "080-新番号"

---

Notes

• resourceName: Operations require an accurate resourceName
• Duplicates: Multiple contacts with the same name can be created
• Sync: Changes are reflected immediately
• Delete: Permanent deletion (no trash)