communication
Google Contacts CLI for Headless Automation
Use the Google Contacts CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
7 functions 7 read 0 write OAuth browser flow auth
Google Contacts CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The Google Contacts CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Google Contacts CLI for Headless Automation
kosmokrator integrations:configure google_contacts --set access_token="$GOOGLE_CONTACTS_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call google_contacts.google_contacts_create '{"name":"example_name","email":"example_email","phone":"example_phone","company":"example_company","title":"example_title","address":"example_address","notes":"example_notes"}' --json Discovery Before Execution
Agents and scripts can inspect Google Contacts docs and schemas before choosing a function.
kosmo integrations:docs google_contacts --json
kosmo integrations:docs google_contacts.google_contacts_create --json
kosmo integrations:schema google_contacts.google_contacts_create --json
kosmo integrations:search "Google Contacts" --json
kosmo integrations:list --json Useful Google Contacts CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
google_contacts.google_contacts_create | Read | name, email, phone, company, title, address, notes | Create a new Google Contact with name, email, phone, company, title, address, and notes. |
google_contacts.google_contacts_delete | Read | resource_name | Permanently delete a Google Contact by resource name. |
google_contacts.google_contacts_get | Read | resource_name | Get full details of a single Google Contact including notes, websites, and group memberships. |
google_contacts.google_contacts_list | Read | max_results, page_token | List all Google Contacts sorted by first name with pagination. |
google_contacts.google_contacts_list_groups | Read | none | List all Google Contact groups/labels (e.g., Friends, Family, custom groups) with member counts. |
google_contacts.google_contacts_search_contacts | Read | query, max_results | Fuzzy search Google Contacts by name, email, or phone. Matches partial strings (e.g., "john", "acme.com", "555"). Use this to look up contacts before sending emails with gmail_send. |
google_contacts.google_contacts_update | Read | resource_name, name, email, phone, company, title, address, notes | Update an existing Google Contact. Unspecified fields are preserved. Email, phone, and address are added alongside existing values; name, company, title, and notes are replaced. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.