mcpField
G
gcontacts

gcontacts

github.com/naoterumakerProductivity4624 installsUpdated 36w ago
Repository

About gcontacts

gcontacts is a skill for operating Google Contacts through the gog CLI. It supports searching, viewing, creating, updating, and deleting contacts, as well as browsing organization directory entries.

Key features

  1. 01Search by name, email, or phone
  2. 02List contacts and view details
  3. 03Create contacts with multiple emails and phones
  4. 04Update or delete contacts
  5. 05Browse and search directory contacts
  6. 06JSON and TSV output options

Use cases

  1. 01Find a contact using partial details
  2. 02Add a new customer with organization information
  3. 03Update a contact's phone number or email
  4. 04Search an organization's contact directory

Install

Copy the command and run it in a terminal.

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

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

Details

From the project README

Google Contacts 操作スキル (gog v0.10.0)

gog CLI でGoogle連絡先を操作する。

実行パス: gog

認証アカウント: (gogで認証したアカウント)

Execution Notes

  • exec ツールで実行時、timeout: 60 を指定

連絡先検索

名前・メール・電話で検索
gog contacts search "田中"
gog contacts search "[email protected]"
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 "[email protected]" \
  --phone "090-1234-5678"
複数メール・電話
gog contacts create \
  --name "佐藤花子" \
  --email "[email protected]" \
  --email "[email protected]" \
  --phone "090-1111-2222" \
  --phone "03-1234-5678"

連絡先更新

gog contacts update <resourceName> --name "新しい名前"
gog contacts update <resourceName> --email "[email protected]"
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メモ

出力オプション

オプション説明
--jsonJSON出力
--plainTSV出力
--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 "[email protected]" \
  --phone "03-1234-5678" \
  --organization "株式会社ABC" \
  --title "営業部長" \
  --note "2026年2月商談開始"
連絡先更新
# 電話番号変更
gog contacts update "people/c1234567890" --phone "080-新番号"

注意事項

  • resourceName: 操作には正確なresourceNameが必要
  • 重複: 同名の連絡先は複数作成可能
  • 同期: 変更は即時反映
  • 削除: 完全削除（ゴミ箱なし）

Comments

Markdown supported