Let agents search Google Contacts and your Workspace directory, and create or update contacts. The gateway injects your OAuth token so agents never see it.
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.
The Google Contacts connect window in Buckle before a Google client is set up.
What agents can do
Area
What agents can do
Contacts
List, search, and read contacts. Create, update, and delete contacts
Other contacts
List and search people you’ve emailed but not saved
Directory
List and search people in your Google Workspace directory
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
Do I need my own Google client for Contacts?
Yes, on Cloud and self-hosted. Follow the Google setup guide once and enable the People API.
Does the agent see my Google token?
No. The token stays in Buckle, and the gateway adds it at the proxy. See How it works.
Can agents read contacts without editing them?
Yes. Allow read tools and block or require approval for writes when you grant the connection.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Buckle","colors":{"primary":"#ff6a13","light":"#ff8236","dark":"#e55e0f"},"logo":{"light":"https://mintcdn.com/onecli-17d3f772/5_AFCR2UNaqNo0AT/logo/logo-full-light.svg?fit=max\u0026auto=format\u0026n=5_AFCR2UNaqNo0AT\u0026q=85\u0026s=30ceea1dd3505e0e9dea50b544521ced","dark":"https://mintcdn.com/onecli-17d3f772/5_AFCR2UNaqNo0AT/logo/logo-full-dark.svg?fit=max\u0026auto=format\u0026n=5_AFCR2UNaqNo0AT\u0026q=85\u0026s=120ef96cf376422549781454d97dd810","href":"https://buckle.dev"},"favicon":"https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/favicon.svg?fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=ddda982106e5fd52c3815a54c183f4b1","appearance":{"default":"light"},"background":{"color":{"light":"#FAFAF9","dark":"#1A1918"}},"navbar":{"links":[{"href":"https://github.com/trybuckle/buckle","label":"GitHub"},{"href":"https://buckle.dev","label":"Install"}]},"footer":{"socials":{"github":"https://github.com/trybuckle"}},"fonts":{"heading":{"family":"Chakra Petch","weight":700,"source":"fonts/ChakraPetch-700.woff2","format":"woff2"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"GitHub","icon":"https://mintlify.s3.us-west-1.amazonaws.com/onecli-17d3f772/images/github.svg","href":"https://github.com/buckle"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"onecli-17d3f772","hasAudioNarration":false,"actualSubdomain":"onecli-17d3f772","customDomains":[],"gitSource":{"type":"github","owner":"trybuckle","repo":"buckle-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6af9ac749033d7e87e8c505a"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af9b4b9e79e0e5d703531fb","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"API Reference","count":240},{"language":"default","tag":"Workspace","count":105},{"language":"default","tag":"Integrations","count":88},{"language":"default","tag":"All app connections","count":64},{"language":"default","tag":"Enterprise","count":57},{"language":"default","tag":"Organization","count":52},{"language":"default","tag":"Apps","count":29},{"language":"default","tag":"Channels","count":28},{"language":"default","tag":"Platform","count":21},{"language":"default","tag":"Guides","count":17}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"a.nav-anchor div.mr-4.rounded-md{--tw-ring-color: transparent !important;--tw-ring-shadow: 0 0 0 0 transparent !important;--tw-ring-offset-shadow: 0 0 0 0 transparent !important;box-shadow:none!important;background:transparent!important;filter:none!important;transition:opacity 0.15s ease!important}a.nav-anchor:hover div.mr-4.rounded-md{--tw-ring-color: transparent !important;--tw-ring-shadow: 0 0 0 0 transparent !important;--tw-ring-offset-shadow: 0 0 0 0 transparent !important;box-shadow:none!important;background:transparent!important;filter:none!important;opacity:0.7!important}a.nav-anchor div.mr-4.rounded-md img{opacity:1!important;filter:none!important;background:transparent!important}a.nav-anchor:hover div.mr-4.rounded-md img{opacity:1!important;filter:none!important;background:transparent!important}.dark a.nav-anchor div.mr-4.rounded-md img,[data-theme=\"dark\"] a.nav-anchor div.mr-4.rounded-md img{filter:invert(1)!important}"}],"page":{"pagePath":"integrations/google-contacts","slug":"/integrations/google-contacts","pageMetadata":{"title":"Let AI Agents Look Up and Update Google Contacts","sidebarTitle":"Google Contacts","description":"Let agents search Google Contacts and your Workspace directory, and create or update contacts. The gateway injects your OAuth token so agents never see it.","canonical":"https://buckle.dev/docs/integrations/google-contacts","href":"/integrations/google-contacts"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Let agents search Google Contacts and your Workspace directory, and create or update contacts. The gateway injects your OAuth token so agents never see it.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Frame,Heading,OptimizedImage,Step,Steps,Table}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsxs(_components.p,{children:[`Google Contacts uses `,_jsx(_components.strong,{children:`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.`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-you-will-set-up`,children:`What you will set up`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`A Google OAuth client with the People API enabled`}),`\n`,_jsx(_components.li,{children:`A Google Contacts connection authorized with your account`}),`\n`,_jsx(_components.li,{children:`Per-agent, per-tool access, with approval for deletes`}),`\n`]}),`\n`,_jsx(`a`,{id:`self-hosted`,style:{scrollMarginTop:`8rem`}}),`\n`,_jsx(Heading,{level:`2`,id:`connect-google-contacts`,children:`Connect Google Contacts`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Set up your Google client`,children:_jsxs(_components.p,{children:[`Follow the `,_jsx(_components.a,{href:`/integrations/google`,children:`Google setup guide`}),` once. Enable the `,_jsx(_components.strong,{children:`People API`}),` in your Google Cloud project as part of it.`]})}),_jsxs(Step,{title:`Connect`,children:[_jsxs(_components.p,{children:[`In the Buckle dashboard, open `,_jsx(_components.strong,{children:`Settings`}),` > `,_jsx(_components.strong,{children:`Apps`}),` > `,_jsx(_components.strong,{children:`Google Contacts`}),` and click `,_jsx(_components.strong,{children:`Connect Google Contacts`}),`. Pick your Google account and click `,_jsx(_components.strong,{children:`Allow`}),`.`]}),_jsx(Frame,{caption:`The Google Contacts connect window in Buckle before a Google client is set up.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/google-contacts/buckle-connect-google-contacts.png?fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=5f2758befd2d51d6e682ca839b126a5b`,alt:`Buckle connect window for Google Contacts showing Configuration required, the setup guide link, and the Configure credentials button.`,\"data-og-width\":`960`,width:`960`,\"data-og-height\":`1062`,height:`1062`,\"data-path\":`images/integrations/google-contacts/buckle-connect-google-contacts.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/google-contacts/buckle-connect-google-contacts.png?w=280\u0026fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=e59348ba7ff1a8facc93a6c71bcdc88d 280w, https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/google-contacts/buckle-connect-google-contacts.png?w=560\u0026fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=afcb978e5c8e0655037c51c5eb45ba75 560w, https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/google-contacts/buckle-connect-google-contacts.png?w=840\u0026fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=76b6e545c03ff3dfcc6f343031de23a2 840w, https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/google-contacts/buckle-connect-google-contacts.png?w=1100\u0026fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=a20120707d2829768a08b166d6b37ef2 1100w, https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/google-contacts/buckle-connect-google-contacts.png?w=1650\u0026fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=cf01285fbd30e6623d3b5d49e725570a 1650w, https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/google-contacts/buckle-connect-google-contacts.png?w=2500\u0026fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=3783aa96276406f0c8c525ff56727276 2500w`})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`what-agents-can-do`,children:`What agents can do`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Area`}),_jsx(_components.th,{children:`What agents can do`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Contacts`})}),_jsx(_components.td,{children:`List, search, and read contacts. Create, update, and delete contacts`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Other contacts`})}),_jsx(_components.td,{children:`List and search people you’ve emailed but not saved`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Directory`})}),_jsx(_components.td,{children:`List and search people in your Google Workspace directory`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`controlling-access`,children:`Controlling access`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/guides/agent-access`,children:`Grant`}),` the connection to each agent that needs it, and choose per tool what runs freely, what needs approval, and what’s blocked. Put `,_jsx(_components.strong,{children:`Delete contact`}),` behind approval. Organization `,_jsx(_components.a,{href:`/guides/rules`,children:`rules`}),` add guardrails on top. A blocked request never reaches Google.`]}),`\n`,_jsxs(_components.p,{children:[`To disconnect, remove the connection in `,_jsx(_components.strong,{children:`Settings`}),` > `,_jsx(_components.strong,{children:`Apps`}),` > `,_jsx(_components.strong,{children:`Google Contacts`}),`, then revoke Buckle at `,_jsx(_components.a,{href:`https://myaccount.google.com/permissions`,children:`myaccount.google.com/permissions`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Do I need my own Google client for Contacts?`,id:`do-i-need-my-own-google-client-for-contacts`,children:_jsxs(_components.p,{children:[`Yes, on Cloud and self-hosted. Follow the `,_jsx(_components.a,{href:`/integrations/google`,children:`Google setup guide`}),` once and enable the `,_jsx(_components.strong,{children:`People API`}),`.`]})}),_jsx(Accordion,{title:`Does the agent see my Google token?`,id:`does-the-agent-see-my-google-token`,children:_jsxs(_components.p,{children:[`No. The token stays in Buckle, and the gateway adds it at the proxy. See `,_jsx(_components.a,{href:`/how-it-works`,children:`How it works`}),`.`]})}),_jsx(Accordion,{title:`Can agents read contacts without editing them?`,id:`can-agents-read-contacts-without-editing-them`,children:_jsxs(_components.p,{children:[`Yes. Allow read tools and block or require approval for writes when you `,_jsx(_components.a,{href:`/guides/agent-access`,children:`grant`}),` the connection.`]})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Let AI Agents Look Up and Update Google Contacts","sidebarTitle":"Google Contacts","description":"Let agents search Google Contacts and your Workspace directory, and create or update contacts. The gateway injects your OAuth token so agents never see it.","canonical":"https://buckle.dev/docs/integrations/google-contacts","href":"/integrations/google-contacts"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"What you will set up","slug":"what-you-will-set-up","depth":2,"children":[]},{"title":"Connect Google Contacts","slug":"connect-google-contacts","depth":2,"children":[]},{"title":"What agents can do","slug":"what-agents-can-do","depth":2,"children":[]},{"title":"Controlling access","slug":"controlling-access","depth":2,"children":[]},{"title":"FAQ","slug":"faq","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/onecli-17d3f772/e8c5fc0faf4d8de9/infra/cloudfront/docs-response-headers.js"],"subdomain":"onecli-17d3f772","siteName":"Buckle","title":"Let AI Agents Look Up and Update Google Contacts - Buckle","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-15T13:34:02.491Z","originalFileLocation":"integrations/google-contacts.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Let agents search Google Contacts and your Workspace directory, and create or update contacts. The gateway injects your OAuth token so agents never see it.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Buckle\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-17d3f772/eFiEtTXh_9JK0wwc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-17d3f772/eFiEtTXh_9JK0wwc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-17d3f772/eFiEtTXh_9JK0wwc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-17d3f772/eFiEtTXh_9JK0wwc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-17d3f772/eFiEtTXh_9JK0wwc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-17d3f772/eFiEtTXh_9JK0wwc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-17d3f772/eFiEtTXh_9JK0wwc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-17d3f772/eFiEtTXh_9JK0wwc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-17d3f772/eFiEtTXh_9JK0wwc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Let AI Agents Look Up and Update Google Contacts - Buckle\">\u003cmeta data-mint-head property=\"og:description\" content=\"Let agents search Google Contacts and your Workspace directory, and create or update contacts. The gateway injects your OAuth token so agents never see it.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Buckle\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://buckle.dev/docs/integrations/google-contacts\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://onecli-17d3f772.mintlify.site/docs/_mintlify/api/og/v2?division=All+app+connections\u0026amp;title=Let+AI+Agents+Look+Up+and+Update+Google+Contacts\u0026amp;description=Let+agents+search+Google+Contacts+and+your+Workspace+directory%2C+and+create+or+update+contacts.+The+gateway+injects+your+OAuth+token+so+agents+never+see+it.\u0026amp;theme=14ca75cbbb2a0e9ba5cd5703\u0026amp;signature=83fd8723dfa5b5c354bce50e07269114c357d841291e269cd48b751d67026a31\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Let AI Agents Look Up and Update Google Contacts - Buckle\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Let agents search Google Contacts and your Workspace directory, and create or update contacts. The gateway injects your OAuth token so agents never see it.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://onecli-17d3f772.mintlify.site/docs/_mintlify/api/og/v2?division=All+app+connections\u0026amp;title=Let+AI+Agents+Look+Up+and+Update+Google+Contacts\u0026amp;description=Let+agents+search+Google+Contacts+and+your+Workspace+directory%2C+and+create+or+update+contacts.+The+gateway+injects+your+OAuth+token+so+agents+never+see+it.\u0026amp;theme=14ca75cbbb2a0e9ba5cd5703\u0026amp;signature=83fd8723dfa5b5c354bce50e07269114c357d841291e269cd48b751d67026a31\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/onecli-17d3f772/eFiEtTXh_9JK0wwc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Buckle\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ff6a13\">\u003clink data-mint-head rel=\"canonical\" href=\"https://buckle.dev/docs/integrations/google-contacts\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/integrations/google-contacts.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://onecli-17d3f772.mintlify.dev/#organization\",\"name\":\"Buckle\",\"url\":\"https://onecli-17d3f772.mintlify.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/onecli-17d3f772/5_AFCR2UNaqNo0AT/logo/logo-full-light.svg?fit=max\u0026auto=format\u0026n=5_AFCR2UNaqNo0AT\u0026q=85\u0026s=30ceea1dd3505e0e9dea50b544521ced\"}},{\"@type\":\"WebSite\",\"@id\":\"https://onecli-17d3f772.mintlify.dev/docs#website\",\"name\":\"Buckle\",\"url\":\"https://onecli-17d3f772.mintlify.dev/docs\",\"publisher\":{\"@id\":\"https://onecli-17d3f772.mintlify.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://buckle.dev/docs/integrations/google-contacts#webpage\",\"url\":\"https://buckle.dev/docs/integrations/google-contacts\",\"name\":\"Let AI Agents Look Up and Update Google Contacts\",\"description\":\"Let agents search Google Contacts and your Workspace directory, and create or update contacts. The gateway injects your OAuth token so agents never see it.\",\"dateModified\":\"2026-11-15T13:34:02.491Z\",\"isPartOf\":{\"@id\":\"https://onecli-17d3f772.mintlify.dev/docs#website\"},\"breadcrumb\":{\"@id\":\"https://buckle.dev/docs/integrations/google-contacts#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://buckle.dev/docs/integrations/google-contacts#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"All app connections\",\"item\":\"https://onecli-17d3f772.mintlify.dev/docs/integrations/affinity\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Let AI Agents Look Up and Update Google Contacts\",\"item\":\"https://buckle.dev/docs/integrations/google-contacts\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://buckle.dev/docs/integrations/google-contacts#article\",\"headline\":\"Let AI Agents Look Up and Update Google Contacts\",\"name\":\"Let AI Agents Look Up and Update Google Contacts\",\"description\":\"Let agents search Google Contacts and your Workspace directory, and create or update contacts. The gateway injects your OAuth token so agents never see it.\",\"url\":\"https://buckle.dev/docs/integrations/google-contacts\",\"mainEntityOfPage\":{\"@id\":\"https://buckle.dev/docs/integrations/google-contacts#webpage\"},\"dateModified\":\"2026-11-15T13:34:02.491Z\",\"publisher\":{\"@id\":\"https://onecli-17d3f772.mintlify.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://onecli-17d3f772.mintlify.dev/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Buckle\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Buckle\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/integrations/google-contacts.md","siteName":"Buckle","nav":{"global":{"anchors":[{"anchor":"GitHub","icon":"https://mintlify.s3.us-west-1.amazonaws.com/onecli-17d3f772/images/github.svg","href":"https://github.com/buckle"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"Integrations","groups":[{"group":"Integrations","root":{"title":"Integrations: Connect Agents to External Services","sidebarTitle":"Overview","href":"/integrations"},"pages":[{"title":"App Connections: How OAuth \u0026 API Keys Work","sidebarTitle":"App Connections","href":"/integrations/app-connections"},{"title":"Custom Connections: Connect Any API With a Key","sidebarTitle":"Custom connections","href":"/integrations/custom-connections"},{"title":"Chat With AI Agents and Approve Actions in Slack","sidebarTitle":"Slack","href":"/integrations/slack"},{"title":"Keep LLM API Keys Out of Your AI Agents","sidebarTitle":"LLMs","href":"/integrations/llms"},{"title":"External Vaults: Connect Password Managers","sidebarTitle":"External Vaults","href":"/vaults/overview"}]},{"group":"Cloud integrations","pages":[{"title":"Prospect and Enrich Leads in Apollo.io With Agents","sidebarTitle":"Apollo.io","href":"/integrations/apollo-io"},{"title":"Use AWS From AI Agents Without Exposing Keys","sidebarTitle":"AWS","href":"/integrations/aws"},{"title":"Let AI Agents Open PRs and Issues on GitHub","sidebarTitle":"GitHub","href":"/integrations/github"},{"title":"Org-Approved GitHub Repo Access for AI Agents","sidebarTitle":"GitHub App","href":"/integrations/github-app"},{"title":"Let AI Agents Query Datadog Metrics and Monitors","sidebarTitle":"Datadog","href":"/integrations/datadog"},{"title":"Let AI Agents Update HubSpot CRM Records","sidebarTitle":"HubSpot","href":"/integrations/hubspot"},{"title":"Let AI Agents Triage Sentry Errors","sidebarTitle":"Sentry","href":"/integrations/sentry"},{"title":"Let AI Agents Read and Write OneNote Notebooks","sidebarTitle":"Microsoft OneNote","href":"/integrations/microsoft-onenote"},{"title":"Connect AI Agents to Outlook Mail in Microsoft 365","sidebarTitle":"Outlook Mail","href":"/integrations/outlook-mail"},{"title":"Let AI Agents Book Meetings in Outlook Calendar","sidebarTitle":"Outlook Calendar","href":"/integrations/outlook-calendar"}]},{"group":"All app connections","pages":[{"title":"Connect AI Agents to Affinity CRM With an API Key","sidebarTitle":"Affinity","href":"/integrations/affinity"},{"title":"Let AI Agents Manage Attio CRM Records","sidebarTitle":"Attio","href":"/integrations/attio"},{"title":"Run Clay Enrichment From AI Agents","sidebarTitle":"Clay","href":"/integrations/clay"},{"title":"Query PostHog Analytics and Flags From Agents","sidebarTitle":"PostHog","href":"/integrations/posthog"},{"title":"Connect AI Agents to Salesforce With an External App","sidebarTitle":"Salesforce","href":"/integrations/salesforce"},{"title":"Turn Timeless Meetings Into Agent Follow-Ups","sidebarTitle":"Timeless","href":"/integrations/timeless"},{"title":"Let Agents Search Circleback Meeting Notes","sidebarTitle":"Circleback","href":"/integrations/circleback"},{"title":"Run HeyReach LinkedIn Campaigns From AI Agents","sidebarTitle":"HeyReach","href":"/integrations/heyreach"},{"title":"Automate Dripify LinkedIn Outreach With Agents","sidebarTitle":"Dripify","href":"/integrations/dripify"},{"title":"Let On-Call Agents Triage PagerDuty Incidents","sidebarTitle":"PagerDuty","href":"/integrations/pagerduty"},{"title":"Query Coralogix Logs and Metrics From Agents","sidebarTitle":"Coralogix","href":"/integrations/coralogix"},{"title":"Search Company Knowledge in Onyx From Agents","sidebarTitle":"Onyx","href":"/integrations/onyx"},{"title":"Scoped Cloudflare API Tokens for AI Agents","sidebarTitle":"Cloudflare","href":"/integrations/cloudflare"},{"title":"Set Up One Google OAuth Client for All Google Apps","sidebarTitle":"Google (setup)","href":"/integrations/google"},{"title":"Let AI Agents Search, Draft, and Send Gmail","sidebarTitle":"Gmail","href":"/integrations/gmail"},{"title":"Let AI Agents Schedule Meetings in Google Calendar","sidebarTitle":"Google Calendar","href":"/integrations/google-calendar"},{"title":"Give AI Agents Access to Google Drive Files","sidebarTitle":"Google Drive","href":"/integrations/google-drive"},{"title":"Let AI Agents Draft and Edit Google Docs","sidebarTitle":"Google Docs","href":"/integrations/google-docs"},{"title":"Let AI Agents Read and Update Google Sheets","sidebarTitle":"Google Sheets","href":"/integrations/google-sheets"},{"title":"Generate Google Slides Decks With AI Agents","sidebarTitle":"Google Slides","href":"/integrations/google-slides"},{"title":"Build Google Forms and Read Responses With Agents","sidebarTitle":"Google Forms","href":"/integrations/google-forms"},{"title":"Create Google Meet Links From AI Agents","sidebarTitle":"Google Meet","href":"/integrations/google-meet"},{"title":"Search and Organize Google Photos With AI Agents","sidebarTitle":"Google Photos","href":"/integrations/google-photos"},{"title":"Track To-Dos in Google Tasks From AI Agents","sidebarTitle":"Google Tasks","href":"/integrations/google-tasks"},{"title":"Automate Google Workspace User Admin With Agents","sidebarTitle":"Google Admin","href":"/integrations/google-admin"},{"title":"Pull GA4 Reports Into AI Agents","sidebarTitle":"Google Analytics","href":"/integrations/google-analytics"},{"title":"Let AI Agents Check Indexing in Search Console","sidebarTitle":"Google Search Console","href":"/integrations/google-search-console"},{"title":"Automate Google Classroom Coursework With Agents","sidebarTitle":"Google Classroom","href":"/integrations/google-classroom"},{"title":"Manage YouTube Playlists and Analytics With Agents","sidebarTitle":"YouTube","href":"/integrations/youtube"},{"title":"Let AI Agents Search and Update Notion Pages","sidebarTitle":"Notion","href":"/integrations/notion"},{"title":"Let AI Agents Create and Triage Jira Issues","sidebarTitle":"Jira","href":"/integrations/jira"},{"title":"Give AI Agents Search and Edit Access to Confluence","sidebarTitle":"Confluence","href":"/integrations/confluence"},{"title":"Let AI Agents Manage Your Todoist Tasks","sidebarTitle":"Todoist","href":"/integrations/todoist"},{"title":"Give AI Agents Safe Access to Your Dropbox Files","sidebarTitle":"Dropbox","href":"/integrations/dropbox"},{"title":"Deploy to Fly.io From an Agent Without Exposing Tokens","sidebarTitle":"Fly.io","href":"/integrations/flyio"},{"title":"Let AI Agents Post to LinkedIn on Your Behalf","sidebarTitle":"LinkedIn","href":"/integrations/linkedin"},{"title":"Connect AI Agents to Monday.com Boards","sidebarTitle":"Monday.com","href":"/integrations/monday"},{"title":"Administer MongoDB Atlas Clusters With Agents","sidebarTitle":"MongoDB Atlas","href":"/integrations/mongodb-atlas"},{"title":"Sync Navan Bookings and Expenses With AI Agents","sidebarTitle":"Navan","href":"/integrations/navan"},{"title":"Let AI Agents Send Email With Resend","sidebarTitle":"Resend","href":"/integrations/resend"},{"title":"Send SMS and WhatsApp From AI Agents With Twilio","sidebarTitle":"Twilio","href":"/integrations/twilio"},{"title":"Zendesk Integration: Tickets and Help Center","sidebarTitle":"Zendesk","href":"/integrations/zendesk"},{"title":"Manage Supabase Projects With AI Agents","sidebarTitle":"Supabase","href":"/integrations/supabase"},{"title":"Call Claude and Gemini on Vertex AI From Agents","sidebarTitle":"Vertex AI","href":"/integrations/vertex-ai"},{"title":"Let AI Agents Edit Webflow CMS and Publish Sites","sidebarTitle":"Webflow","href":"/integrations/webflow"},{"title":"Let AI Agents Schedule Zoom Meetings and Get Recordings","sidebarTitle":"Zoom","href":"/integrations/zoom"},{"title":"Give Agents AWS Access With an IAM Role, Not Keys","sidebarTitle":"AWS Role","href":"/integrations/aws-role"},{"title":"Bitbucket Repos, Pull Requests, and Pipelines","sidebarTitle":"Bitbucket","href":"/integrations/bitbucket"},{"title":"Manage Docker Hub Repositories From AI Agents","sidebarTitle":"Docker Hub","href":"/integrations/docker"},{"title":"Read Fathom Meeting Summaries From AI Agents","sidebarTitle":"Fathom","href":"/integrations/fathom"},{"title":"Give AI Agents Access to Fireflies Transcripts","sidebarTitle":"Fireflies","href":"/integrations/fireflies"},{"title":"Let AI Agents Work With GitLab Merge Requests","sidebarTitle":"GitLab","href":"/integrations/gitlab"},{"title":"Send Google Chat Messages From AI Agents","sidebarTitle":"Google Chat","description":"Let agents read and send Google Chat messages and manage spaces and members. Connect with your Google OAuth client, and the gateway injects the token.","href":"/integrations/google-chat"},{"title":"Let AI Agents Look Up and Update Google Contacts","sidebarTitle":"Google Contacts","href":"/integrations/google-contacts"},{"title":"Let AI Agents Read Your Granola Meeting Notes","sidebarTitle":"Granola","description":"Give agents read-only access to Granola meeting notes and folders. Connect in a minute with an API key that the gateway injects and keeps hidden.","href":"/integrations/granola"},{"title":"Route Agent Package Installs Through JFrog","sidebarTitle":"JFrog Artifactory","href":"/integrations/jfrog-artifactory"},{"title":"Let AI Agents File and Update Linear Issues","sidebarTitle":"Linear","href":"/integrations/linear"},{"title":"Run Snowflake SQL From an Agent, Token Hidden","sidebarTitle":"Snowflake","href":"/integrations/snowflake"},{"title":"Use a Restricted Stripe Key With AI Agents","sidebarTitle":"Stripe","href":"/integrations/stripe"},{"title":"Let AI Agents Manage Trello Boards and Cards","sidebarTitle":"Trello","href":"/integrations/trello"},{"title":"Let AI Agents Deploy and Manage Vercel Projects","sidebarTitle":"Vercel","href":"/integrations/vercel"},{"title":"Let AI Agents Post and Read on X (Twitter)","sidebarTitle":"X","href":"/integrations/x"},{"title":"Let AI Agents Work Zoho CRM Leads and Deals","sidebarTitle":"Zoho CRM","href":"/integrations/zoho-crm"},{"title":"Let AI Agents Draft Word Docs in OneDrive","sidebarTitle":"Microsoft Word","href":"/integrations/microsoft-word"}]},{"group":"LLMs","pages":[{"title":"Connect Claude to Agents With a Token or API Key","sidebarTitle":"Anthropic","href":"/integrations/anthropic"},{"title":"Use OpenAI API Keys and Codex OAuth With AI Agents","sidebarTitle":"OpenAI","href":"/integrations/openai"}]},{"group":"External Vaults","pages":[{"title":"Bitwarden Vault: Sync Secrets to the Gateway","sidebarTitle":"Bitwarden","href":"/vaults/bitwarden"},{"title":"1Password Vault: Service Account Integration","sidebarTitle":"1Password","href":"/vaults/1password"}]}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference"}]},{"tab":"SDKs","pages":[{"title":"SDKs","href":"/sdks"}]}]},"basePath":"","title":"Let AI Agents Look Up and Update Google Contacts - Buckle","buildId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","deploymentId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-0domioUa.js","DynamicMarkdown-BcGRTrw6.js","zoom-image-lightbox-DsiWwPWR.js","lightbox-handle-r17bVUz3.js"]}