Google Business Profile connector for AI agents

Tools your local marketing agent reaches for on Google Business Profile, scoped per user.

CALL ANY TOOL

Manage local listings end to end: locations, reviews, posts, and performance insights, scoped to each user's own Business Profile access.

googlebusinessprofile_accept_invitation

Accept invitation

Accept a pending invitation to become an administrator (owner or manager) of a Google Business Profile account. Requires the invitation resource name in the form accounts/{account_id}/invitations/{invitation_id}. The request body is empty. Returns an empty response on success; once accepted, the invitation is consumed and the caller becomes an admin of the account.

Parameters

Name

Type

Required

Description

name

string

Required

The resource name of the invitation to accept, in the form accounts/{account_id}/invitations/{invitation_id}. Example: accounts/106234523651626475467/invitations/109876543210987654321.

googlebusinessprofile_categories_batch_get

Get categories batch

googlebusinessprofile_complete_verification

Complete verification

googlebusinessprofile_create_account

Create account

googlebusinessprofile_create_location

Create location

Create a new location under a Google Business Profile account. Requires the parent account resource name and a business title. Optionally supply a storefront address, phone numbers, primary/additional categories, and regular business hours. Set validateOnly to true to validate the request without creating the location.

Parameters

Name

Type

Required

Description

parent

string

Required

The account resource name under which to create the location, in the form accounts/{account_id}. Example: accounts/106234523651626475467.

title

string

Required

The business name (title) for the new location, reflecting the real-world business name as used consistently on the storefront. No taglines or special characters. Example: Cascade Coffee Roasters.

language_code

string

Optional

The BCP 47 language code for the location's data (e.g. "en", "fr", "de"). Required by Google — defaults to "en" if not specified.

primary_category_name

string

Optional

Primary category resource name for the location, e.g. categories/gcid:restaurant. Maps to categories.primaryCategory.name. Optional but recommended.

primary_phone

string

Optional

Primary phone number for the location, in E.164 or local format. Maps to phoneNumbers.primaryPhone. Optional.

regular_hours_periods

array

Optional

Regular business hours as an array of time periods. Each period is an object: {"openDay": "MONDAY", "openTime": "09:00", "closeDay": "MONDAY", "closeTime": "17:00"}. openDay/closeDay must be one of MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY. openTime/closeTime are 24-hour HH:MM strings. Optional.

requestId

string

Optional

Optional unique request ID (max 50 chars) used to detect duplicate creation requests. Leave blank to omit.

storefront_address_lines

array

Optional

Street address lines for the location's storefront address (up to 5 lines), e.g. ["1600 Amphitheatre Pkwy"]. Required together with storefront_locality and storefront_region_code if providing a storefront address.

storefront_administrative_area

string

Optional

State or administrative area of the storefront address, e.g. CA. Optional even when providing an address.

storefront_locality

string

Optional

City/locality of the storefront address. Required together with storefront_address_lines and storefront_region_code if providing a storefront address.

storefront_postal_code

string

Optional

Postal/ZIP code of the storefront address. Optional even when providing an address.

storefront_region_code

string

Optional

CLDR region code (ISO 3166-1 alpha-2) of the storefront address's country, e.g. US. Required together with storefront_address_lines and storefront_locality if providing a storefront address.

validateOnly

boolean

Optional

If true, validates the request without actually creating the location. Useful for checking field values before committing. Defaults to false.

googlebusinessprofile_create_post

Post create

Create a local post (What's New update) for a Google Business Profile location using the legacy My Business API v4. Requires the parent resource name (accounts/{account_id}/locations/{location_id}), a topicType, and a summary. Supports STANDARD posts with an optional call-to-action button and photo/video media. EVENT and OFFER post types can be attempted by also supplying the event or offer object as raw JSON, but are not deeply validated by this tool. Note: this legacy v4 endpoint requires separate Google allow-list approval for the OAuth client; a 403 response may indicate the client has not been allow-listed rather than a tool defect.

Parameters

Name

Type

Required

Description

parent

string

Required

The parent resource name under which to create the local post, in the form accounts/{account_id}/locations/{location_id}. Example: accounts/106234523651626475467/locations/12345678901234567890.

summary

string

Required

The main text content of the local post. Required for all topic types. Example: 'Join us this weekend for our summer sale!'

topicType

string

Required

The topic type of the local post. STANDARD is a general update. EVENT requires the event field to also be set. OFFER requires the offer field to also be set. ALERT is used for urgent announcements (e.g. COVID-19).

callToActionType

string

Optional

The type of call-to-action button to show on the post. One of BOOK, ORDER, SHOP, LEARN_MORE, SIGN_UP, CALL. Omit for no call-to-action button.

callToActionUrl

string

Optional

The target URL for the call-to-action button. Required if callToActionType is set to a value other than CALL. Example: https://example.com/summer-sale.

event

object

Optional

Required when topicType is EVENT. A JSON object describing the event: {"title": string, "schedule": {"startDate": {"year":Y,"month":M,"day":D}, "startTime": {"hours":H,"minutes":M}, "endDate": {...}, "endTime": {...}}}. Example: {"title": "Summer Sale Kickoff", "schedule": {"startDate": {"year":2026,"month":7,"day":10}, "endDate": {"year":2026,"month":7,"day":10}}}.

languageCode

string

Optional

The language of the local post content, as a BCP 47 language code. Example: en-US. If omitted, the account's default language is used.

media

array

Optional

Optional array of media items (photos or videos) to attach to the post. Each item is an object with mediaFormat (PHOTO or VIDEO) and sourceUrl (a publicly accessible URL to the media file). Example: [{"mediaFormat": "PHOTO", "sourceUrl": "https://example.com/photo.jpg"}].

offer

object

Optional

Optional when topicType is OFFER. A JSON object describing the offer: {"couponCode": string, "redeemOnlineUrl": string, "termsConditions": string}. Example: {"couponCode": "SUMMER26", "redeemOnlineUrl": "https://example.com/redeem", "termsConditions": "Valid through July 31, 2026."}.

googlebusinessprofile_delete_answer

Delete answer

googlebusinessprofile_delete_media

Delete media

googlebusinessprofile_delete_post

Post delete

googlebusinessprofile_fetch_multi_daily_metrics

Fetch multi daily metrics

googlebusinessprofile_get_chain

Get chain

googlebusinessprofile_get_insights

Get insights

googlebusinessprofile_get_location_attributes

Get location attributes

googlebusinessprofile_get_notification_settings

Get notification settings

googlebusinessprofile_get_review

Get review

googlebusinessprofile_invite_account_admin

Invite account admin

googlebusinessprofile_list_account_admins

List account admins

googlebusinessprofile_list_answers

List answers

googlebusinessprofile_list_categories

List categories

googlebusinessprofile_list_locations

List locations

googlebusinessprofile_list_posts

List posts

googlebusinessprofile_remove_account_admin

Remove account admin

googlebusinessprofile_report_local_post_insights

Report local post insights

googlebusinessprofile_search_chains

Search chains

googlebusinessprofile_search_google_locations

Search google locations

googlebusinessprofile_transfer_location

Transfer location

googlebusinessprofile_update_account

Update account

googlebusinessprofile_update_listing

Update listing

Update a Google Business Profile location's business information (a partial update via PATCH). Provide the location resource name, only the fields you want to change, and an update_mask naming exactly those fields — Google clears any field named in update_mask that is left blank in the request body, so update_mask must match the fields you actually supply. Supports updating the business title, primary phone number, website URL, regular hours (as a list of open/close periods), storefront address, and primary category.

Parameters

Name

Type

Required

Description

location

string

Required

The location resource name to update, in the form locations/{location_id}. Example: locations/12345678901234567890.

update_mask

string

Required

Comma-separated list of top-level Location fields to update, matching exactly the fields you supply in this request (e.g. "title" if you only set title; "title,phoneNumbers" if you set both title and primary_phone). Valid field names: title, phoneNumbers, websiteUri, regularHours, storefrontAddress, categories. WARNING: Google clears any field named here that you leave blank — do not include a field name unless you are also supplying its value.

primary_category_name

string

Optional

New primary category resource name for the location, e.g. categories/gcid:restaurant. Maps to categories.primaryCategory.name. Leave blank to keep the existing primary category.

primary_phone

string

Optional

New primary phone number for the location, in E.164 or local format. Maps to phoneNumbers.primaryPhone. Leave blank to keep the existing phone number.

regular_hours_periods

array

Optional

New regular business hours as an array of time periods, replacing the existing regularHours entirely. Each period is an object: {"openDay": "MONDAY", "openTime": "09:00", "closeDay": "MONDAY", "closeTime": "17:00"}. openDay/closeDay must be one of MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY. openTime/closeTime are 24-hour HH:MM strings. Leave blank to keep existing hours.

storefront_address_lines

array

Optional

New street address lines for the location's storefront address (e.g. ["1600 Amphitheatre Pkwy"]). Required together with storefront_locality and storefront_region_code if updating the storefront address.

storefront_administrative_area

string

Optional

State or administrative area of the storefront address, e.g. CA. Optional even when updating the address.

storefront_locality

string

Optional

City/locality of the storefront address. Required together with storefront_address_lines if updating the storefront address.

storefront_postal_code

string

Optional

Postal/ZIP code of the storefront address. Optional even when updating the address.

storefront_region_code

string

Optional

CLDR region code (ISO 3166-1 alpha-2) of the storefront address's country, e.g. US. Required together with storefront_address_lines and storefront_locality if updating the storefront address.

title

string

Optional

New business name (title) for the location. Google does not allow marketing taglines or special characters. Leave blank to keep the existing title.

website_uri

string

Optional

New website URL for the location. Leave blank to keep the existing website URL.

googlebusinessprofile_update_notification_settings

Update notification settings

googlebusinessprofile_upsert_answer

Upsert answer

For more tools, view docs.

Build your Agent

Same auth pattern across LangChain, OpenAI, Anthropic, and Google ADK.

import { ScalekitClient } from "@scalekit-sdk/node";
import { createReactAgent } from "@langchain/langgraph/prebuilt";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

// Google Business Profile tools scoped to this user
const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["googlebusinessprofile"], toolNames: [
    "googlebusinessprofile_list_locations",
    "googlebusinessprofile_get_location",
    "googlebusinessprofile_list_reviews"] },
  pageSize: 100,
});

const agent = createReactAgent({ llm, tools });
await agent.invoke({ messages: [{ role: "user", content: "Reply to the new 2-star review and pull last month's search views" }] });

import OpenAI from "openai";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const openai = new OpenAI();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["googlebusinessprofile"] }, pageSize: 100,
});

const res = await openai.chat.completions.create({
  model: "gpt-5",
  messages: [{ role: "user", content: "Reply to the new 2-star review and pull last month's search views" }],
  tools,
});

// Execute the tool call with the user's vaulted googlebusinessprofile credential
await sk.tools.executeTool(res.choices[0].message.tool_calls[0], "user_123");

import Anthropic from "@anthropic-ai/sdk";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const anthropic = new Anthropic();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["googlebusinessprofile"] }, pageSize: 100,
});

const msg = await anthropic.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Reply to the new 2-star review and pull last month's search views" }],
  tools,
});

// Tool call runs with the user's vaulted googlebusinessprofile credential
await sk.tools.executeTool(msg.content, "user_123");

import { Agent } from "@google/adk/agents";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["googlebusinessprofile"] }, pageSize: 100,
});

const agent = new Agent({
  name: "googlebusinessprofile_agent",
  model: "gemini-2.5-pro",
  instruction: "Google Business Profile tools scoped to this user",
  tools,
});

await agent.run("Reply to the new 2-star review and pull last month's search views");

Try these prompts

Copy any prompt into your agent. Each maps directly to a Google Business Profile tool. Click to copy, paste into your agent, done.

Reviews

Copy the prompt

Copied

List reviews at 3 stars or below for the downtown location.

Copy the prompt

Copied

Reply to the newest review thanking the customer and offering to make it right.

Copy the prompt

Copied

How many unreplied reviews does the airport location have?

Posts and listings

Copy the prompt

Copied

Publish a weekend-hours update post for the downtown location.

Copy the prompt

Copied

Get the full listing details for location loc_9021.

Copy the prompt

Copied

Create an offer post for 20% off this weekend.

Performance

Copy the prompt

Copied

Pull search views and map clicks for last month.

Copy the prompt

Copied

Compare this month's calls to last month for the downtown location.

Copy the prompt

Copied

List all locations under account acc_442.

SEE HOW AUTH WORKS

Your users connect once. Their Google Business Profile credentials stay vaulted, every call is checked, and every action is logged.

Authorize

Your user connects

Google Business Profile

once. We tie it to their identity and the meetings they approved — no shared bot account, no org-wide access

Who:

user ‘A’

when:

Once per user

access:

Limited to user

Store

Their

Google Business Profile

token lives in a vault scoped to them. User A's meetings are never reachable by an agent acting for user B, even on the same connection

vault:

encrypted

scope:

per-user

tokens:

auto-refreshed

Resolve

When your agent calls a

Google Business Profile

tool, we fetch the right token server-side. It never touches your agent, never appears in the LLM context, never shows up in your logs

speed:

~40ms

check:

before every call

seen by:

nobody

Audit

Every

Google Business Profile

tool call is logged — who triggered it, which meeting was fetched, what came back. 90 days of history, tied to the user who authorized it

history:

90 days

export:

SIEM-ready

logged:

every call

Test other agents

See the same per-user auth pattern across other marketing and local-listings connectors.

GTM and RevOps Teams

Outbound prospecting agent

Searches Apollo for prospects matching your ICP, scores and ranks them, drafts personalized outreach in Gmail, and logs every send to Google Sheets. Mail goes out as the rep, not from a shared inbox.

GTM and RevOps Teams

CRM AI agent

Reads the Granola transcript after every call, extracts next steps and updates the HubSpot record, drafts the follow-up in Gmail, and confirms in Slack, all on the rep's own delegated OAuth.

GTM and RevOps Teams

Deal intelligence agent

Pulls recent Gong calls, scores deal risk with an LLM, cross-references the record in Attio, and DMs each owner their at-risk deals in Slack. Every read is scoped to that rep's own access.

GTM and RevOps Teams

Competitive intelligence briefing agent

Scans Gong calls for competitor mentions, matches each one to its Notion battlecard, and DMs every affected rep a single Slack digest per cycle. Every call runs as the PMM who owns the briefing, never a shared bot.

Why Scalekit

Secure your agent's access. Connectors ship in minutes

01.

Shared tokens break per-user analytics

A shared Google Business Profile token looks fine in a demo. In production every listing update looks like one service account, and you cannot tell which user triggered it. Scalekit resolves the credential of the actual user who triggered the agent, never a shared bot.

// shared token
audit → bot_service_account

// scalekit
audit → user_abc ✓

02.

Authentication is not authorization

03.

Multi-tenancy is architectural

04.

Google Business Profile today. Ten connectors tomorrow.

“Our agents act across Salesforce, Gong, Google Drive, and more, on behalf of every customer. Scalekit behind the scenes meant we can keep adding tools without ever rebuilding how credentials or tool calling work.”

Venu Madhav Kattagoni

Head of Engineering / Von

FAQs

Frequently Asked Questions

Does the agent access Google Business Profile as the user or through a shared key?

As the user. Scalekit resolves the credential of the person who triggered the agent at request time, so every Google Business Profile action in your audit trail is attributed to a real user, not a shared service account.

Where is the Google Business Profile token stored?

In an AES-256 encrypted vault with per-tenant namespacing. Tokens are resolved at request time, never enter LLM context, refresh automatically, and can be revoked from one dashboard.

Can I limit what the agent does in Google Business Profile?

Yes. Filter by tool name in listScopedTools to expose only what you want. Scalekit also enforces scope checks before every API call.

What happens when a user revokes access?

The credential is invalidated at the next tool call. The call fails closed, other users' connections are unaffected, and the revocation is logged in the audit chain.

Can the agent reply to reviews without a human checking the wording first?

Only if you scope reply_to_review into the tool set you expose. Keep the agent to list_reviews and get_performance_metrics for a read-only rollout, or require a human approval step before replies post publicly.

On this page

Tool and actions Framework Compatibility Starter Prompt Auth Lifecycle Try Other Agents Why Scalekit