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 MCP, CLI, and Lua Integration for AI Agents

Google Contacts integration docs for AI agents: MCP gateway setup, Google Contacts CLI commands, Lua API reference, credentials, and function schemas.

7 functions 6 read 1 write OAuth browser flow auth

Submit Google Contacts feedback View package source

Google Contacts for agents

OAuth can be configured in web hosts through redirect and in CLI hosts through local/device authorization; runtime works with stored tokens.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata

integration_slug: google_contacts
route_slug: google-contacts
package: google-contacts
auth_strategy: oauth2_authorization_code OAuth browser flow
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. Google Contacts CLIHeadless setup and direct function calls. Google Contacts MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

Google Contacts MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Google Contacts.

Google Contacts CLI Matrix

Use these pages for direct Google Contacts CLI workflows in scripts, CI, cron, and agent wrappers.

CI Google Contacts CLI for CI. Cron Jobs Google Contacts CLI for cron jobs. Shell Scripts Google Contacts CLI for shell scripts. Headless Automation Google Contacts CLI for headless automation. Coding Agents Google Contacts CLI for coding agents.

Function Catalog

Function	Type	Parameters	Description
`google_contacts.google_contacts_list_connections`	Read `read`	4	List contacts (connections) from the authenticated user's Google Contacts. Returns names, emails, phone numbers, biographies, organizations, and photos. Supports pagination and incremental sync.
`google_contacts.google_contacts_get_connection`	Read `read`	2	Get detailed information about a specific contact by resource name (e.g., "people/c123456789"). Returns names, emails, phone numbers, biographies, organizations, and photos.
`google_contacts.google_contacts_create_contact`	Write `write`	5	Create a new contact in Google Contacts. Provide at least a name. You can also add email addresses, phone numbers, and a biography (notes).
`google_contacts.google_contacts_list_contact_groups`	Read `read`	3	List all contact groups in the user's Google Contacts. Includes system groups (e.g., "My Contacts", "Starred") and user-created groups. Returns group name, type, and member count.
`google_contacts.google_contacts_get_contact_group`	Read `read`	1	Get details of a specific contact group by resource name (e.g., "contactGroups/myContacts"). Returns the group name, type, member count, and member resource names.
`google_contacts.google_contacts_list_other_contacts`	Read `read`	3	List "Other Contacts" — people the user has interacted with (e.g., via email) but hasn't added to their contacts. Returns names, email addresses, and phone numbers.
`google_contacts.google_contacts_get_current_user`	Read `read`	0	Get the authenticated user's own Google profile information — display name, email addresses, and profile photo.