Skip to main content

Overview

OneCLI connects AI agents to Google Contacts through Google’s OAuth flow. Agents can search contacts and your Workspace directory, and create, update, or delete contacts. The gateway injects the token into every request, so your agent never sees it. Google Contacts uses your own Google OAuth client, on OneCLI Cloud and self-hosted alike. One client covers every Google app in OneCLI, so if you’ve already set one up for another Google app, skip to step 2.

Connect Google Contacts

1

Set up your Google client

Follow the Google setup guide once. Enable the People API in your Google Cloud project as part of it.
2

Connect

In the OneCLI dashboard, open Connections > Google Contacts and click Connect Google Contacts. Pick your Google account and click Allow.
OneCLI connect window for Google Contacts showing Configuration required, the setup guide link, and the Configure credentials button.

The Google Contacts connect window in OneCLI before a Google client is set up.

What agents can do

Controlling access

Grant the connection to each agent that needs it, and choose per tool what runs freely, what needs approval, and what’s blocked. Put Delete contact behind approval. Organization rules add guardrails on top. A blocked request never reaches Google. To disconnect, remove the connection in Connections > Google Contacts, then revoke OneCLI at myaccount.google.com/permissions.