MCP server for Google Business Profile: locations, reviews, local posts and performance metrics.
io.github.A1-x-Tech/mcp-google-business MCP Server
MCP server for Google Business Profile that exposes access to locations, reviews, local posts, and performance metrics. It is published as mcp-google-business and documented in a GitHub repository under the same name, with badges for npm, CI, and Glama.
🛠️ Key Features
Google Business Profile data access
Locations
Reviews
Local posts
Performance metrics
🚀 Use Cases
Retrieve and work with business profile locations
Read and use customer review data
Manage or generate local post content
Track business performance metrics
⚡ Developer Benefits
Integrates Google Business Profile entities (locations, reviews, posts, metrics) via MCP
Repository and package are available under A1-x-Tech/mcp-google-business
⚠️ Limitations
Readme excerpt provided does not specify supported methods, auth details, endpoints, or rate limits.
A1 Google Business Profile MCP lets an AI app work with your Google Business Profile locations in natural language. Inspect locations and performance, respond to reviews, prepare local posts and update profile information deliberately.
It connects to Google’s current Business Profile APIs and the legacy API where reviews and posts still live. A Google account and OAuth credentials alone are not enough: Google must approve Basic API Access for the Cloud project.
20 tools. Location and account data, performance, reviews, local posts, categories and attributes.
Real approval gate. Projects start at 0 QPM; every API call fails until Google approves the Basic API Access application.
Separate release boundary. A prepared reply, post or location update changes public business information only after the client confirms the write operation.
Four API surfaces. Account Management, Business Information, Performance and legacy v4 work through one business.manage OAuth scope.
Start with a read-only question:
List my locations and show the newest reviews that do not have a reply.
In Settings → MCP servers, select Add server, choose STDIO, enter the command npx -y mcp-google-business@latest and environment variables GOOGLE_BUSINESS_CLIENT_ID, GOOGLE_BUSINESS_CLIENT_SECRET, GOOGLE_BUSINESS_REFRESH_TOKEN, then select Save and Restart.
The current official path is Settings → Extensions. For a custom desktop extension, open Advanced settings → Extension Developer → Install Extension…, select a .mcpb file and follow the prompts.
This repository currently publishes an npm stdio package and does not contain a .mcpb bundle. For Claude Desktop builds that still support local configuration, use the following JSON stdio configuration as a fallback:
In those builds, save it to ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows.
Add {"mcpServers":{"google-business":{"type":"stdio","command":"npx","args":["-y","mcp-google-business@latest"],"env":{"GOOGLE_BUSINESS_CLIENT_ID":"your_client_id","GOOGLE_BUSINESS_CLIENT_SECRET":"your_client_secret","GOOGLE_BUSINESS_REFRESH_TOKEN":"your_refresh_token"}}}} to ~/.cursor/mcp.json on macOS/Linux or %USERPROFILE%\.cursor\mcp.json on Windows. Cursor MCP documentation
List locations, categories, attributes and current profile information.
Show calls, direction requests and search keyword impressions for a chosen period.
Find fresh reviews, draft a reply and publish it after confirmation.
Prepare, update or remove a local post.
Update a selected location field or attribute after showing the exact change.
What can change
Operation
What happens
Confirmation boundary
Accounts, locations, categories, attributes, performance, reviews and posts
Reads existing profile data
No change
Update a location or its attributes
Changes public business profile data
Changes a location
Reply to a review
Publishes a public owner reply
Changes public content
Create or update a local post
Publishes or changes public local content
Changes public content
Delete a review reply or local post
Removes public content
Destructive
Raw API request
May call any write or delete endpoint
Potentially destructive
The AI client controls confirmations; the server marks tools so the client can distinguish inspection from a live change.
Getting access
Google requires both OAuth and Basic API Access approval.
Use a verified and active Business Profile that has existed for at least 60 days; apply from an owner or manager account and have a business website that matches the application.
Create a Google Cloud project, enable My Business Account Management API, Business Information API, Business Profile Performance API and Google My Business API (legacy v4).
Submit the GBP API contact form as Application for Basic API Access. Before approval, quota is 0 QPM; approved projects receive 300 QPM per API.
Create an OAuth client, obtain a refresh token for https://www.googleapis.com/auth/business.manage, and set the three GOOGLE_BUSINESS_* variables.
Treat the client secret and refresh token as passwords. An access token is a short-lived alternative for one-off use.
Configuration
Variable
Required
Description
GOOGLE_BUSINESS_CLIENT_ID
Yes*
OAuth client ID.
GOOGLE_BUSINESS_CLIENT_SECRET
Yes*
OAuth client secret.
GOOGLE_BUSINESS_REFRESH_TOKEN
Yes*
OAuth refresh token with business.manage.
GOOGLE_BUSINESS_ACCESS_TOKEN
Yes*
Short-lived alternative to the OAuth trio.
GOOGLE_BUSINESS_TIMEOUT_MS
No
Per-request timeout; default 60000 ms.
GOOGLE_BUSINESS_MAX_RETRIES
No
Temporary-error retries; default 3.
* Provide either the OAuth trio or an access token. API host overrides are documented in the tool reference.
Data, limits and background work
Google receives the profile requests. Anonymous telemetry includes installation and version data plus tool names, never OAuth secrets, profile data, arguments or prompts. For each tool call it also sends the outcome and, on failure, an excerpt of the error text with e-mails, addresses, tokens, numbers of 4+ digits and quoted text replaced by #; a value from your request can appear in it if the error text contains it. Set ASKADS_TELEMETRY=0 to opt out.
Real edit caps. Approved projects receive 300 QPM per API; Google also limits each Business Profile to 10 edits per minute. Performance metrics can lag by a few days, and review replies require verified locations.
No background monitoring. The server runs only while called. If your AI app supports scheduled tasks, it can periodically review new feedback or metrics.
OAuth2 client id from Google Cloud Console (refresh flow).
GOOGLE_BUSINESS_CLIENT_SECRETsecret
OAuth2 client secret. Treat it as a secret.
GOOGLE_BUSINESS_REFRESH_TOKENsecret
OAuth2 refresh token with the business.manage scope. Treat it as a secret.
GOOGLE_BUSINESS_ACCESS_TOKENsecret
Ready-made access token (~1 h) as an alternative to the refresh-flow trio above.
GOOGLE_BUSINESS_TIMEOUT_MSdefault 60000
Per-request timeout in milliseconds.
GOOGLE_BUSINESS_MAX_RETRIESdefault 3
Retries on transient errors (429 always; 5xx/network on idempotent calls).
GOOGLE_BUSINESS_OAUTH_PORT
Fixed port for the loopback listener of the in-chat login (127.0.0.1 + PKCE). Set it when the client runs over SSH port forwarding; otherwise a free port is picked per login.