Skip to main content

Overview

Buckle 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 Buckle Cloud and self-hosted alike. One client covers every Google app in Buckle, so if you’ve already set one up for another Google app, skip to step 2.

What you will set up

  • A Google OAuth client with the People API enabled
  • A Google Contacts connection authorized with your account
  • Per-agent, per-tool access, with approval for deletes

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 Buckle dashboard, open Settings > Apps > Google Contacts and click Connect Google Contacts. Pick your Google account and click Allow.
Buckle connect window for Google Contacts showing Configuration required, the setup guide link, and the Configure credentials button.

The Google Contacts connect window in Buckle 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 Settings > Apps > Google Contacts, then revoke Buckle at myaccount.google.com/permissions.

FAQ

Yes, on Cloud and self-hosted. Follow the Google setup guide once and enable the People API.
No. The token stays in Buckle, and the gateway adds it at the proxy. See How it works.
Yes. Allow read tools and block or require approval for writes when you grant the connection.