Can I use Google Contacts as a CLI?

Yes. KosmoKrator exposes a Google Contacts CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Google Contacts through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Google Contacts tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Google Contacts credentials stored?

Google Contacts credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Google Contacts MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

Google Contacts CLI for AI Agents

Use the Google Contacts CLI from KosmoKrator to call Google Contacts tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

Google Contacts CLI Setup

Google Contacts can be configured headlessly with `kosmokrator integrations:configure google-contacts`.

Install, configure, and verify

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure google-contacts --enable --read allow --write ask --json
kosmokrator integrations:doctor google-contacts --json
kosmokrator integrations:status --json

Credentials

Authentication type: Manual OAuth token oauth2_manual_token. Configure credentials once, then reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.

No credentials are required.

Command Patterns

The generic command is stable across every integration. The provider shortcut is shorter for humans.

Generic CLI call

kosmo integrations:call google-contacts.google_contacts_people_search_directory_people '{}' --json

Provider shortcut

kosmo integrations:google-contacts google_contacts_people_search_directory_people '{}' --json

Discovery

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

Discovery commands

kosmo integrations:docs google-contacts --json
kosmo integrations:docs google-contacts.google_contacts_people_search_directory_people --json
kosmo integrations:schema google-contacts.google_contacts_people_search_directory_people --json
kosmo integrations:search "Google Contacts" --json
kosmo integrations:list --json

Automation Contexts

The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.

CI Run integration calls from CI jobs with JSON output, explicit credentials, and predictable exit status. Cron Jobs Schedule repeatable integration workflows from cron while keeping credentials in KosmoKrator config. Shell Scripts Call integration functions from shell scripts with stable JSON input and output. Headless Automation Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers. Coding Agents Let coding agents discover schemas and execute integration functions through CLI commands or MCP.

CLI Functions

Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.

`google-contacts.google_contacts_people_search_directory_people`

People Search Directory People (GET /v1/people:searchDirectoryPeople).

Read read

Parameters: none

Generic call

kosmo integrations:call google-contacts.google_contacts_people_search_directory_people '{}' --json

Shortcut

kosmo integrations:google-contacts google_contacts_people_search_directory_people '{}' --json

`google-contacts.google_contacts_people_delete_contact_photo`

People Delete Contact Photo (DELETE /v1/{+resourceName}:deleteContactPhoto).

Write write

Parameters: none

Generic call

kosmo integrations:call google-contacts.google_contacts_people_delete_contact_photo '{}' --json

Shortcut

kosmo integrations:google-contacts google_contacts_people_delete_contact_photo '{}' --json

`google-contacts.google_contacts_people_batch_delete_contacts`

People Batch Delete Contacts (POST /v1/people:batchDeleteContacts).

Write write

Parameters: none

Generic call

kosmo integrations:call google-contacts.google_contacts_people_batch_delete_contacts '{}' --json

Shortcut

kosmo integrations:google-contacts google_contacts_people_batch_delete_contacts '{}' --json

`google-contacts.google_contacts_people_create_contact`

People Create Contact (POST /v1/people:createContact).

Write write

Parameters: none

Generic call

kosmo integrations:call google-contacts.google_contacts_people_create_contact '{}' --json

Shortcut

kosmo integrations:google-contacts google_contacts_people_create_contact '{}' --json

`google-contacts.google_contacts_people_list_directory_people`

People List Directory People (GET /v1/people:listDirectoryPeople).

Read read

Parameters: none

Generic call

kosmo integrations:call google-contacts.google_contacts_people_list_directory_people '{}' --json

Shortcut

kosmo integrations:google-contacts google_contacts_people_list_directory_people '{}' --json

`google-contacts.google_contacts_people_update_contact`

People Update Contact (PATCH /v1/{+resourceName}:updateContact).

Write write

Parameters: none

Generic call

kosmo integrations:call google-contacts.google_contacts_people_update_contact '{}' --json

Shortcut

kosmo integrations:google-contacts google_contacts_people_update_contact '{}' --json

`google-contacts.google_contacts_people_update_contact_photo`

People Update Contact Photo (PATCH /v1/{+resourceName}:updateContactPhoto).

Write write

Parameters: none

Generic call

kosmo integrations:call google-contacts.google_contacts_people_update_contact_photo '{}' --json

Shortcut

kosmo integrations:google-contacts google_contacts_people_update_contact_photo '{}' --json

`google-contacts.google_contacts_people_get`

People Get (GET /v1/{+resourceName}).

Read read

Parameters: none

Generic call

kosmo integrations:call google-contacts.google_contacts_people_get '{}' --json

Shortcut

kosmo integrations:google-contacts google_contacts_people_get '{}' --json

`google-contacts.google_contacts_people_delete_contact`

People Delete Contact (DELETE /v1/{+resourceName}:deleteContact).

Write write

Parameters: none

Generic call

kosmo integrations:call google-contacts.google_contacts_people_delete_contact '{}' --json

Shortcut

kosmo integrations:google-contacts google_contacts_people_delete_contact '{}' --json

`google-contacts.google_contacts_people_get_batch_get`

People Get Batch Get (GET /v1/people:batchGet).

Read read

Parameters: none

Generic call

kosmo integrations:call google-contacts.google_contacts_people_get_batch_get '{}' --json

Shortcut

kosmo integrations:google-contacts google_contacts_people_get_batch_get '{}' --json

`google-contacts.google_contacts_people_batch_update_contacts`

People Batch Update Contacts (POST /v1/people:batchUpdateContacts).

Write write

Parameters: none

Generic call

kosmo integrations:call google-contacts.google_contacts_people_batch_update_contacts '{}' --json

Shortcut

kosmo integrations:google-contacts google_contacts_people_batch_update_contacts '{}' --json

`google-contacts.google_contacts_people_search_contacts`

People Search Contacts (GET /v1/people:searchContacts).

Read read

Parameters: none

Generic call

kosmo integrations:call google-contacts.google_contacts_people_search_contacts '{}' --json

Shortcut

kosmo integrations:google-contacts google_contacts_people_search_contacts '{}' --json

`google-contacts.google_contacts_people_batch_create_contacts`

People Batch Create Contacts (POST /v1/people:batchCreateContacts).

Write write

Parameters: none

Generic call

kosmo integrations:call google-contacts.google_contacts_people_batch_create_contacts '{}' --json

Shortcut

kosmo integrations:google-contacts google_contacts_people_batch_create_contacts '{}' --json

`google-contacts.google_contacts_people_connections_list`

People Connections List (GET /v1/{+resourceName}/connections).

Read read

Parameters: none

Generic call

kosmo integrations:call google-contacts.google_contacts_people_connections_list '{}' --json

Shortcut

kosmo integrations:google-contacts google_contacts_people_connections_list '{}' --json

`google-contacts.google_contacts_other_contacts_list`

Other Contacts List (GET /v1/otherContacts).

Read read

Parameters: none

Generic call

kosmo integrations:call google-contacts.google_contacts_other_contacts_list '{}' --json

Shortcut

kosmo integrations:google-contacts google_contacts_other_contacts_list '{}' --json

`google-contacts.google_contacts_other_contacts_search`

Other Contacts Search (GET /v1/otherContacts:search).

Read read

Parameters: none

Generic call

kosmo integrations:call google-contacts.google_contacts_other_contacts_search '{}' --json

Shortcut

kosmo integrations:google-contacts google_contacts_other_contacts_search '{}' --json

`google-contacts.google_contacts_other_contacts_copy_other_contact_to_my_contacts_group`

Other Contacts Copy Other Contact To My Contacts Group (POST /v1/{+resourceName}:copyOtherContactToMyContactsGroup).

Write write

Parameters: none

Generic call

kosmo integrations:call google-contacts.google_contacts_other_contacts_copy_other_contact_to_my_contacts_group '{}' --json

Shortcut

kosmo integrations:google-contacts google_contacts_other_contacts_copy_other_contact_to_my_contacts_group '{}' --json

`google-contacts.google_contacts_contact_groups_create`

Contact Groups Create (POST /v1/contactGroups).

Write write

Parameters: none

Generic call

kosmo integrations:call google-contacts.google_contacts_contact_groups_create '{}' --json

Shortcut

kosmo integrations:google-contacts google_contacts_contact_groups_create '{}' --json

`google-contacts.google_contacts_contact_groups_get`

Contact Groups Get (GET /v1/{+resourceName}).

Read read

Parameters: none

Generic call

kosmo integrations:call google-contacts.google_contacts_contact_groups_get '{}' --json

Shortcut

kosmo integrations:google-contacts google_contacts_contact_groups_get '{}' --json

`google-contacts.google_contacts_contact_groups_list`

Contact Groups List (GET /v1/contactGroups).

Read read

Parameters: none

Generic call

kosmo integrations:call google-contacts.google_contacts_contact_groups_list '{}' --json

Shortcut

kosmo integrations:google-contacts google_contacts_contact_groups_list '{}' --json

`google-contacts.google_contacts_contact_groups_batch_get`

Contact Groups Batch Get (GET /v1/contactGroups:batchGet).

Read read

Parameters: none

Generic call

kosmo integrations:call google-contacts.google_contacts_contact_groups_batch_get '{}' --json

Shortcut

kosmo integrations:google-contacts google_contacts_contact_groups_batch_get '{}' --json

`google-contacts.google_contacts_contact_groups_update`

Contact Groups Update (PUT /v1/{+resourceName}).

Write write

Parameters: none

Generic call

kosmo integrations:call google-contacts.google_contacts_contact_groups_update '{}' --json

Shortcut

kosmo integrations:google-contacts google_contacts_contact_groups_update '{}' --json

`google-contacts.google_contacts_contact_groups_delete`

Contact Groups Delete (DELETE /v1/{+resourceName}).

Write write

Parameters: none

Generic call

kosmo integrations:call google-contacts.google_contacts_contact_groups_delete '{}' --json

Shortcut

kosmo integrations:google-contacts google_contacts_contact_groups_delete '{}' --json

`google-contacts.google_contacts_contact_groups_members_modify`

Contact Groups Members Modify (POST /v1/{+resourceName}/members:modify).

Write write

Parameters: none

Generic call

kosmo integrations:call google-contacts.google_contacts_contact_groups_members_modify '{}' --json

Shortcut

kosmo integrations:google-contacts google_contacts_contact_groups_members_modify '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

google-contacts.google_contacts_people_search_directory_people 0 parameters

Schema command

kosmo integrations:schema google-contacts.google_contacts_people_search_directory_people --json

Parameter	Type	Required	Description
No parameters.

google-contacts.google_contacts_people_delete_contact_photo 0 parameters

Schema command

kosmo integrations:schema google-contacts.google_contacts_people_delete_contact_photo --json

Parameter	Type	Required	Description
No parameters.

google-contacts.google_contacts_people_batch_delete_contacts 0 parameters

Schema command

kosmo integrations:schema google-contacts.google_contacts_people_batch_delete_contacts --json

Parameter	Type	Required	Description
No parameters.

google-contacts.google_contacts_people_create_contact 0 parameters

Schema command

kosmo integrations:schema google-contacts.google_contacts_people_create_contact --json

Parameter	Type	Required	Description
No parameters.

google-contacts.google_contacts_people_list_directory_people 0 parameters

Schema command

kosmo integrations:schema google-contacts.google_contacts_people_list_directory_people --json

Parameter	Type	Required	Description
No parameters.

google-contacts.google_contacts_people_update_contact 0 parameters

Schema command

kosmo integrations:schema google-contacts.google_contacts_people_update_contact --json

Parameter	Type	Required	Description
No parameters.

google-contacts.google_contacts_people_update_contact_photo 0 parameters

Schema command

kosmo integrations:schema google-contacts.google_contacts_people_update_contact_photo --json

Parameter	Type	Required	Description
No parameters.

google-contacts.google_contacts_people_get 0 parameters

Schema command

kosmo integrations:schema google-contacts.google_contacts_people_get --json

Parameter	Type	Required	Description
No parameters.

google-contacts.google_contacts_people_delete_contact 0 parameters

Schema command

kosmo integrations:schema google-contacts.google_contacts_people_delete_contact --json

Parameter	Type	Required	Description
No parameters.

google-contacts.google_contacts_people_get_batch_get 0 parameters

Schema command

kosmo integrations:schema google-contacts.google_contacts_people_get_batch_get --json

Parameter	Type	Required	Description
No parameters.

google-contacts.google_contacts_people_batch_update_contacts 0 parameters

Schema command

kosmo integrations:schema google-contacts.google_contacts_people_batch_update_contacts --json

Parameter	Type	Required	Description
No parameters.

google-contacts.google_contacts_people_search_contacts 0 parameters

Schema command

kosmo integrations:schema google-contacts.google_contacts_people_search_contacts --json

Parameter	Type	Required	Description
No parameters.

google-contacts.google_contacts_people_batch_create_contacts 0 parameters

Schema command

kosmo integrations:schema google-contacts.google_contacts_people_batch_create_contacts --json

Parameter	Type	Required	Description
No parameters.

google-contacts.google_contacts_people_connections_list 0 parameters

Schema command

kosmo integrations:schema google-contacts.google_contacts_people_connections_list --json

Parameter	Type	Required	Description
No parameters.

google-contacts.google_contacts_other_contacts_list 0 parameters

Schema command

kosmo integrations:schema google-contacts.google_contacts_other_contacts_list --json

Parameter	Type	Required	Description
No parameters.

google-contacts.google_contacts_other_contacts_search 0 parameters

Schema command

kosmo integrations:schema google-contacts.google_contacts_other_contacts_search --json

Parameter	Type	Required	Description
No parameters.

google-contacts.google_contacts_other_contacts_copy_other_contact_to_my_contacts_group 0 parameters

Schema command

kosmo integrations:schema google-contacts.google_contacts_other_contacts_copy_other_contact_to_my_contacts_group --json

Parameter	Type	Required	Description
No parameters.

google-contacts.google_contacts_contact_groups_create 0 parameters

Schema command

kosmo integrations:schema google-contacts.google_contacts_contact_groups_create --json

Parameter	Type	Required	Description
No parameters.

google-contacts.google_contacts_contact_groups_get 0 parameters

Schema command

kosmo integrations:schema google-contacts.google_contacts_contact_groups_get --json

Parameter	Type	Required	Description
No parameters.

google-contacts.google_contacts_contact_groups_list 0 parameters

Schema command

kosmo integrations:schema google-contacts.google_contacts_contact_groups_list --json

Parameter	Type	Required	Description
No parameters.

google-contacts.google_contacts_contact_groups_batch_get 0 parameters

Schema command

kosmo integrations:schema google-contacts.google_contacts_contact_groups_batch_get --json

Parameter	Type	Required	Description
No parameters.

google-contacts.google_contacts_contact_groups_update 0 parameters

Schema command

kosmo integrations:schema google-contacts.google_contacts_contact_groups_update --json

Parameter	Type	Required	Description
No parameters.

google-contacts.google_contacts_contact_groups_delete 0 parameters

Schema command

kosmo integrations:schema google-contacts.google_contacts_contact_groups_delete --json

Parameter	Type	Required	Description
No parameters.

google-contacts.google_contacts_contact_groups_members_modify 0 parameters

Schema command

kosmo integrations:schema google-contacts.google_contacts_contact_groups_members_modify --json

Parameter	Type	Required	Description
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.