google-my-business-mcp
This server exposes Google Business Profile REST APIs as MCP tools for managing accounts, locations, local posts, media, reviews, Q&A, performance data, notifications, verifications, and place actions.
Account management: list, get, create, and update business accounts; manage account admins and invitations; transfer locations between accounts.
Location management: list, get, create, update, and delete locations; manage location attributes and admins; search chains and Google locations; retrieve business categories and lodging data.
Local posts: create, read, update, and delete local posts for locations.
Media: create, read, update, and delete media items attached to locations.
Reviews: list and get reviews; create, update, and delete replies to reviews.
Q&A: list, create, update, and delete questions and answers for locations.
Performance: fetch daily metrics time series and monthly search keyword impression data.
Notifications: get and update Pub/Sub notification settings for accounts.
Verification: fetch verification options, start and complete verifications, list verifications, generate verification tokens, and get Voice of Merchant state.
Place actions: create, get, list, update, and delete place action links; list available place action types.
Safety controls: read-only vs. write/destructive tool annotations and optional write confirmation before API calls.
Provides tools for interacting with Google Business Profile / Google My Business APIs, allowing management of business locations, reviews, local posts, media, verification, business information, and performance.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@google-my-business-mcp list my business locations"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Google My Business MCP Server
Inspired by the Google Ads MCP Server.
This repository contains the source code for an MCP server that interacts with the Google Business Profile APIs.
It intentionally contains no Agent workflow, SEO automation, business logic, asset hosting, or high-level orchestration. Its job is to expose Google Business Profile REST methods as MCP tools and return Google API responses.
This is a community project and is not an official Google product.
Tools
The server turns Google REST methods into MCP tools for LLMs and AI agents. Tool names follow this pattern:
gmb_<service>_<resource>_<method>Depending on the available Google APIs and Discovery Documents, tools can cover:
accounts and locations;
business information;
local posts;
location media;
reviews and review replies;
performance;
lodging, place actions, notifications, and verifications.
Path and query parameters are normal tool arguments. Methods with a request
payload accept a body object. Methods whose Google Discovery definition
declares media upload support also accept media_path and an optional
media_content_type.
The server prefers Google's live Discovery Documents. Because Google no longer publishes a working Discovery URL for the legacy v4 surface, the package contains a narrow, version-controlled, contract-tested fallback catalog for Local Posts, media, and reviews. The fallback is used only when live discovery for that service fails.
MCP resources and discovery helpers
The current release exposes Google REST methods as MCP tools only. It does not yet register MCP Resources for Discovery Documents, schemas, or release notes.
TODO: Expose bounded discovery helpers such as
gmb_find_methods,gmb_describe_method, andgmb_describe_schema, or equivalent MCP Resources. Until then, complex request bodies must be checked against the linked Google API reference before execution.
Configuring and namespacing tools
The current release can limit discovery to selected Google service families
with GMB_MCP_SERVICES, and deprecated services can be excluded with
GMB_MCP_INCLUDE_DEPRECATED=0.
TODO: Add a fail-closed per-tool allowlist and optional namespace prefixes without requiring a new configuration framework. Individual MCP clients may apply their own tool allowlist in the meantime.
Related MCP server: My Business Account Management API MCP Server
Safety notes
The MCP server exposes Business Profile data to the Agent or LLM connected to it. Only connect it to clients you trust.
Tool annotations are conservative: GET, HEAD, and OPTIONS are read-only; DELETE is destructive; unknown methods are treated as writes.
Set
GMB_MCP_REQUIRE_WRITE_CONFIRMATION=1to require MCP elicitation before every write. The preview includes the exact resource, target, update mask, body, and other non-secret arguments.Write confirmation fails closed when it is declined, cancelled, unavailable, not explicitly acknowledged, or times out. No Google API request is sent in those cases.
Secret fields and signed URL query strings are redacted from confirmation previews. Do not place credentials in request bodies or source URLs.
Local Post media uses Google's
sourceUrlfield. This project does not host or publish local files for Google to fetch.
The confirmation timeout defaults to 120 seconds. It can be changed to a value
greater than 0 and no more than 600 seconds with
GMB_MCP_WRITE_CONFIRMATION_TIMEOUT_SECONDS.
Setup instructions
Setup has six steps:
Configure Python.
Create or select a Google Cloud project.
Request Google Business Profile API access for that project.
Enable the Google Business Profile APIs you need.
Configure Application Default Credentials.
Configure your MCP client.
Configure Python
Python 3.10 or newer is required. Install pipx, then install the server:
pipx install git+https://github.com/jie8357IOII/google-my-business-mcp.gitEnable APIs
Google Business Profile API access is granted to a Google Cloud project. Follow Google's prerequisites and submit the access request before expecting the legacy Google My Business API to appear in the API Library.
Enable the relevant Google Business Profile APIs in your Google Cloud project. The exact set depends on the tools you intend to use, such as Business Information, Account Management, Performance, or the legacy Google My Business v4 surface.
Google does not provide a separate GBP sandbox. Use a real account you are
authorized to manage, begin with read-only acceptance checks, and only use a
method's validateOnly parameter when that method officially supports it.
Configure credentials
The server uses Application Default Credentials with this OAuth scope:
https://www.googleapis.com/auth/business.manageThe Google account used for authentication must have access to the relevant Business Profile accounts or locations. For a local interactive setup, use an OAuth desktop client you control:
gcloud auth application-default login \
--scopes=https://www.googleapis.com/auth/business.manage,https://www.googleapis.com/auth/cloud-platform \
--client-id-file=YOUR_OAUTH_CLIENT_JSONDo not commit the OAuth client JSON, ADC file, refresh token, or access token.
The server currently reads credentials through ADC; it does not host an OAuth callback or consent flow itself.
TODO: Evaluate an optional built-in OAuth proxy only if remote MCP hosting becomes a supported use case. Local stdio installations should continue to prefer ADC so the server does not store OAuth client secrets.
Configure your MCP client
Point GOOGLE_APPLICATION_CREDENTIALS to the ADC file created during the
previous step:
{
"mcpServers": {
"google-my-business": {
"command": "pipx",
"args": [
"run",
"--spec",
"git+https://github.com/jie8357IOII/google-my-business-mcp.git",
"google-my-business-mcp"
],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_APPLICATION_DEFAULT_CREDENTIALS_JSON",
"GMB_MCP_REQUIRE_WRITE_CONFIRMATION": "1"
}
}
}
}The server uses the MCP stdio transport.
If the package was installed once with pipx install, the MCP client can call
the installed executable directly instead:
{
"mcpServers": {
"google-my-business": {
"command": "google-my-business-mcp",
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_APPLICATION_DEFAULT_CREDENTIALS_JSON",
"GMB_MCP_REQUIRE_WRITE_CONFIRMATION": "1"
}
}
}
}TODO: Add verified client-specific examples for Hermes, Claude Desktop, Cursor, VS Code, and other MCP hosts. The JSON shape and executable resolution can differ between clients and operating systems.
Environment variables
Variable | Default | Purpose |
| ADC default lookup | Path to an ADC-compatible credential file. |
| unset | Preferred quota and Google Cloud project ID. |
| unset | Fallback project ID when |
|
| Set to |
|
| Write confirmation timeout; must be greater than 0 and no more than 600. |
| user cache directory | Directory for Google Discovery Document cache files. |
|
| Discovery cache lifetime in seconds. |
| all registered services | Comma-separated service keys to load. |
|
| Set to |
Current service keys are mybusiness_v4, mybusiness_v1,
account_management, business_information, lodging, place_actions,
notifications, verifications, performance, qanda, and
business_calls.
Try it out
Start your MCP client and verify the server appears in its list of connected servers. Example read-only prompts:
What Business Profile accounts can I access?
List every location I can manage, following all pagination tokens.
Read the latest Local Posts for a selected location.
Show recent reviews for a selected location.
Before asking an Agent to write, enable confirmation and verify the target, body, update mask, media URL, and deletion target shown in the elicitation.
Current limitations and TODO roadmap
The following capabilities are intentionally visible as TODOs rather than being described as available:
TODO — MCP Resources: publish bounded Discovery Document, schema, and release-note resources.
TODO — discovery helper tools: register method search and schema inspection helpers without inflating every tool schema.
TODO — per-tool configuration: add a built-in fail-closed allowlist and optional namespace prefixes.
TODO — client guides: add tested configuration examples for major MCP clients, including Hermes.
TODO — remote authentication: evaluate an OAuth proxy with secure token storage if remote hosting becomes a supported scope.
TODO — remote transport: evaluate MCP Streamable HTTP. The current server supports stdio only.
TODO — deployment artifacts: add Docker and Google Cloud Run instructions only after remote authentication and transport have production tests.
TODO — startup diagnostics: provide a safe readiness report covering ADC, enabled services, Discovery fallback, and tool counts without exposing credentials or customer data.
Developer tokens and login customer IDs are Google Ads concepts and are not GBP TODOs. Telemetry is not collected. Agent workflows, asset hosting, SEO logic, and business-specific orchestration remain outside this repository by design.
Development
git clone https://github.com/jie8357IOII/google-my-business-mcp.git
cd google-my-business-mcp
python -m pip install -e '.[dev]'
pytest
python -m compileall mybusiness_mcp
ruff check mybusiness_mcp testsProject layout:
mybusiness_mcp/
├── server.py # stdio entry point
├── coordinator.py # MCP tool registration and write confirmation
├── auth.py # Google ADC authentication
├── client.py # authenticated REST requests and media uploads
├── discovery.py # Discovery Document to MCP tool definitions
├── legacy_catalog.py # tested fallback for the legacy v4 surface
└── services.py # Google API service registryContributing
Contributions are welcome. See CONTRIBUTING.md.
License
Apache-2.0
Available Tools
72 toolsgmb_accounts_accounts_admins_createA
POST v1/{+parent}/admins. Invites the specified user to become an administrator for the specified account. The invitee must accept the invitation in order to be granted access to the account. See AcceptInvitation to programmatically accept an invitation.
Inputs: parent (required), body, fields, $.xgafv, +2 more.
gmb_accounts_accounts_admins_deleteADestructiveIdempotent
DELETE v1/{+name}. Removes the specified admin from the specified account.
Inputs: name (required), fields, $.xgafv, quotaUser, +1 more.
gmb_accounts_accounts_admins_listBRead-onlyIdempotent
GET v1/{+parent}/admins. Lists the admins for the specified account.
Inputs: parent (required), fields, $.xgafv, quotaUser, +1 more.
gmb_accounts_accounts_admins_patchBIdempotent
PATCH v1/{+name}. Updates the Admin for the specified Account Admin.
Inputs: name (required), body, fields, $.xgafv, +3 more.
gmb_accounts_accounts_createA
POST v1/accounts. Creates an account with the specified name and type under the given parent. - Personal accounts and Organizations cannot be created. - User Groups cannot be created with a Personal account as primary owner. - Location Groups cannot be created with a primary owner of a Personal account if the Personal account is in an Organization. - Location Groups cannot own Location Groups.
Inputs: body, fields, $.xgafv, quotaUser, +1 more.
gmb_accounts_accounts_getARead-onlyIdempotent
GET v1/{+name}. Gets the specified account. Returns NOT_FOUND if the account does not exist or if the caller does not have access rights to it.
Inputs: name (required), fields, $.xgafv, quotaUser, +1 more.
gmb_accounts_accounts_invitations_acceptA
POST v1/{+name}:accept. Accepts the specified invitation.
Inputs: name (required), body, fields, $.xgafv, +2 more.
gmb_accounts_accounts_invitations_declineB
POST v1/{+name}:decline. Declines the specified invitation.
Inputs: name (required), body, fields, $.xgafv, +2 more.
gmb_accounts_accounts_invitations_listARead-onlyIdempotent
GET v1/{+parent}/invitations. Lists pending invitations for the specified account.
Inputs: parent (required), fields, filter, $.xgafv, +2 more.
gmb_accounts_accounts_listARead-onlyIdempotent
GET v1/accounts. Lists all of the accounts for the authenticated user. This includes all accounts that the user owns, as well as any accounts for which the user has management rights.
Inputs: fields, filter, $.xgafv, pageSize, +4 more.
gmb_accounts_accounts_patchAIdempotent
PATCH v1/{+name}. Updates the specified business account. Personal accounts cannot be updated using this method.
Inputs: name (required), body, fields, $.xgafv, +4 more.
gmb_accounts_locations_admins_createA
POST v1/{+parent}/admins. Invites the specified user to become an administrator for the specified location. The invitee must accept the invitation in order to be granted access to the location. See AcceptInvitation to programmatically accept an invitation.
Inputs: parent (required), body, fields, $.xgafv, +2 more.
gmb_accounts_locations_admins_deleteADestructiveIdempotent
DELETE v1/{+name}. Removes the specified admin as a manager of the specified location.
Inputs: name (required), fields, $.xgafv, quotaUser, +1 more.
gmb_accounts_locations_admins_listARead-onlyIdempotent
GET v1/{+parent}/admins. Lists all of the admins for the specified location.
Inputs: parent (required), fields, $.xgafv, quotaUser, +1 more.
gmb_accounts_locations_admins_patchBIdempotent
PATCH v1/{+name}. Updates the Admin for the specified location. Only the AdminRole of the Admin can be updated.
Inputs: name (required), body, fields, $.xgafv, +3 more.
gmb_accounts_locations_transferA
POST v1/{+name}:transfer. Moves a location from an account that the user owns to another account that the same user administers. The user must be an owner of the account the location is currently associated with and must also be at least a manager of the destination account.
Inputs: name (required), body, fields, $.xgafv, +2 more.
gmb_actions_locations_placeactionlinks_createA
POST v1/{+parent}/placeActionLinks. Creates a place action link associated with the specified location, and returns it. The request is considered duplicate if the parent, place_action_link.uri and place_action_link.place_action_type are the same as a previous request.
Inputs: parent (required), body, fields, $.xgafv, +2 more.
gmb_actions_locations_placeactionlinks_deleteADestructiveIdempotent
DELETE v1/{+name}. Deletes a place action link from the specified location.
Inputs: name (required), fields, $.xgafv, quotaUser, +1 more.
gmb_actions_locations_placeactionlinks_getARead-onlyIdempotent
GET v1/{+name}. Gets the specified place action link.
Inputs: name (required), fields, $.xgafv, quotaUser, +1 more.
gmb_actions_locations_placeactionlinks_listARead-onlyIdempotent
GET v1/{+parent}/placeActionLinks. Lists the place action links for the specified location.
Inputs: parent (required), fields, filter, $.xgafv, +4 more.
gmb_actions_locations_placeactionlinks_patchCIdempotent
PATCH v1/{+name}. Updates the specified place action link and returns it.
Inputs: name (required), body, fields, $.xgafv, +3 more.
gmb_actions_placeactiontypemetadata_listARead-onlyIdempotent
GET v1/placeActionTypeMetadata. Returns the list of available place action types for a location or country.
Inputs: fields, filter, $.xgafv, pageSize, +4 more.
gmb_info_accounts_locations_createA
POST v1/{+parent}/locations. Creates a new Location that will be owned by the logged in user.
Inputs: parent (required), body, fields, $.xgafv, +4 more.
gmb_info_accounts_locations_listBRead-onlyIdempotent
GET v1/{+parent}/locations. Lists the locations for the specified account.
Inputs: parent (required), fields, filter, $.xgafv, +6 more.
gmb_info_attributes_listARead-onlyIdempotent
GET v1/attributes. Returns the list of attributes that would be available for a location with the given primary category and country.
Inputs: fields, parent, $.xgafv, showAll, +7 more.
gmb_info_categories_batchgetBRead-onlyIdempotent
GET v1/categories:batchGet. Returns a list of business categories for the provided language and GConcept ids.
Inputs: view, names, fields, $.xgafv, +4 more.
gmb_info_categories_listARead-onlyIdempotent
GET v1/categories. Returns a list of business categories. Search will match the category name but not the category ID. Search only matches the front of a category name (that is, 'food' may return 'Food Court' but not 'Fast Food Restaurant').
Inputs: view, fields, filter, $.xgafv, +6 more.
gmb_info_chains_getARead-onlyIdempotent
GET v1/{+name}. Gets the specified chain. Returns NOT_FOUND if the chain does not exist.
Inputs: name (required), fields, $.xgafv, quotaUser, +1 more.
gmb_info_chains_searchBRead-onlyIdempotent
GET v1/chains:search. Searches the chain based on chain name.
Inputs: fields, $.xgafv, pageSize, chainName, +2 more.
gmb_info_googlelocations_searchC
POST v1/googleLocations:search. Search all of the possible locations that are a match to the specified request.
Inputs: body, fields, $.xgafv, quotaUser, +1 more.
gmb_info_locations_attributes_getgoogleupdatedARead-onlyIdempotent
GET v1/{+name}:getGoogleUpdated. Retrieves attributes for a location as they appear live on Google Maps and Search. This consumer-facing view may have been updated by Google or user-generated content and may differ from the merchant's version.
Inputs: name (required), fields, $.xgafv, quotaUser, +1 more.
gmb_info_locations_deleteADestructiveIdempotent
DELETE v1/{+name}. Deletes a location. If this location cannot be deleted using the API and it is marked so in the google.mybusiness.businessinformation.v1.LocationState, use the Google Business Profile website.
Inputs: name (required), fields, $.xgafv, quotaUser, +1 more.
gmb_info_locations_getARead-onlyIdempotent
GET v1/{+name}. Returns the specified location as last set by the merchant. It may not reflect updates from Google or user-generated content that are live on Google Maps.
Inputs: name (required), fields, $.xgafv, readMask, +2 more.
gmb_info_locations_getattributesARead-onlyIdempotent
GET v1/{+name}. Retrieves attributes for a location as last set by the merchant. It may not reflect updates from Google or user-generated content that are live on Google Maps.
Inputs: name (required), fields, $.xgafv, quotaUser, +1 more.
gmb_info_locations_getgoogleupdatedARead-onlyIdempotent
GET v1/{+name}:getGoogleUpdated. Returns the specified location as it appears live on Google Maps and Search. This consumer-facing view may have been updated by Google or user-generated content and may differ from the merchant's version. The returned GoogleUpdatedLocation contains masks that indicate which fields differ from the merchant's information.
Inputs: name (required), fields, $.xgafv, readMask, +2 more.
gmb_info_locations_patchCIdempotent
PATCH v1/{+name}. Updates the specified location.
Inputs: name (required), body, fields, $.xgafv, +4 more.
gmb_info_locations_updateattributesBIdempotent
PATCH v1/{+name}. Update attributes for a given location.
Inputs: name (required), body, fields, $.xgafv, +3 more.
gmb_lodging_locations_getlodgingARead-onlyIdempotent
GET v1/{+name}. Returns the Lodging of a specific location.
Inputs: name (required), fields, $.xgafv, readMask, +2 more.
gmb_lodging_locations_lodging_getgoogleupdatedBRead-onlyIdempotent
GET v1/{+name}:getGoogleUpdated. Returns the Google updated Lodging of a specific location.
Inputs: name (required), fields, $.xgafv, readMask, +2 more.
gmb_lodging_locations_updatelodgingCIdempotent
PATCH v1/{+name}. Updates the Lodging of a specific location.
Inputs: name (required), body, fields, $.xgafv, +3 more.
gmb_notifications_accounts_getnotificationsettingARead-onlyIdempotent
GET v1/{+name}. Returns the pubsub notification settings for the account.
Inputs: name (required), fields, $.xgafv, quotaUser, +1 more.
gmb_notifications_accounts_updatenotificationsettingAIdempotent
PATCH v1/{+name}. Sets the pubsub notification setting for the account informing Google which topic to send pubsub notifications for. Use the notification_types field within notification_setting to manipulate the events an account wants to subscribe to. An account will only have one notification setting resource, and only one pubsub topic can be set. To delete the setting, update with an empty notification_types
Inputs: name (required), body, fields, $.xgafv, +3 more.
gmb_performance_locations_fetchmultidailymetricstimeseriesARead-onlyIdempotent
GET v1/{+location}:fetchMultiDailyMetricsTimeSeries. Returns the values for each date from a given time range that are associated with the specific daily metrics. Note: Only daily data is available. Hourly metrics are not supported. Example request: GET https://businessprofileperformance.googleapis.com/v1/locations/12345:fetchMultiDailyMetricsTimeSeries?dailyMetrics=WEBSITE_CLICKS&dailyMetrics=CALL_CLICKS&daily_range.start_date.year=2022&daily_range.start_date.month=1&daily_range.start_date.day=1&daily_range.end_date.year=2022&daily_range.end_date.month=3&daily_range.end_date.day=31
Inputs: location (required), fields, $.xgafv, quotaUser, +8 more.
gmb_performance_locations_getdailymetricstimeseriesARead-onlyIdempotent
GET v1/{+name}:getDailyMetricsTimeSeries. Returns the values for each date from a given time range that are associated with the specific daily metric. Note: Only daily data is available. Hourly metrics are not supported. Example request: GET https://businessprofileperformance.googleapis.com/v1/locations/12345:getDailyMetricsTimeSeries?dailyMetric=WEBSITE_CLICKS&daily_range.start_date.year=2022&daily_range.start_date.month=1&daily_range.start_date.day=1&daily_range.end_date.year=2022&daily_range.end_date.month=3&daily_range.end_date.day=31
Inputs: name (required), fields, $.xgafv, quotaUser, +13 more.
gmb_performance_locations_searchkeywords_impressions_mo_4ba8b09fARead-onlyIdempotent
GET v1/{+parent}/searchkeywords/impressions/monthly. Returns the search keywords used to find a business in search or maps. Each search keyword is accompanied by impressions which are aggregated on a monthly basis. Example request: GET https://businessprofileperformance.googleapis.com/v1/locations/12345/searchkeywords/impressions/monthly?monthly_range.start_month.year=2022&monthly_range.start_month.month=1&monthly_range.end_month.year=2022&monthly_range.end_month.month=3
Inputs: parent (required), fields, $.xgafv, pageSize, +9 more.
gmb_qanda_locations_questions_answers_deleteADestructiveIdempotent
[DEPRECATED] DELETE v1/{+name}/answers:delete. Deletes the answer written by the current user to a question.
Inputs: name (required), fields, $.xgafv, quotaUser, +1 more.
gmb_qanda_locations_questions_answers_listARead-onlyIdempotent
[DEPRECATED] GET v1/{+parent}/answers. Returns the paginated list of answers for a specified question.
Inputs: parent (required), fields, $.xgafv, orderBy, +4 more.
gmb_qanda_locations_questions_answers_upsertA
[DEPRECATED] POST v1/{+parent}/answers:upsert. Creates an answer or updates the existing answer written by the user for the specified question. A user can only create one answer per question.
Inputs: parent (required), body, fields, $.xgafv, +2 more.
gmb_qanda_locations_questions_createA
[DEPRECATED] POST v1/{+parent}. Adds a question for the specified location.
Inputs: parent (required), body, fields, $.xgafv, +2 more.
gmb_qanda_locations_questions_deleteADestructiveIdempotent
[DEPRECATED] DELETE v1/{+name}. Deletes a specific question written by the current user.
Inputs: name (required), fields, $.xgafv, quotaUser, +1 more.
gmb_qanda_locations_questions_listARead-onlyIdempotent
[DEPRECATED] GET v1/{+parent}. Returns the paginated list of questions and some of its answers for a specified location. This operation is only valid if the specified location is verified.
Inputs: parent (required), fields, filter, $.xgafv, +6 more.
gmb_qanda_locations_questions_patchAIdempotent
[DEPRECATED] PATCH v1/{+name}. Updates a specific question written by the current user.
Inputs: name (required), body, fields, $.xgafv, +3 more.
gmb_v4_accounts_locations_localposts_createA
POST v4/{parent=accounts//locations/}/localPosts. Creates a local post for a location.
Inputs: parent (required), body.
gmb_v4_accounts_locations_localposts_deleteCDestructiveIdempotent
DELETE v4/{name=accounts//locations//localPosts/*}. Deletes a local post.
Inputs: name (required).
gmb_v4_accounts_locations_localposts_getARead-onlyIdempotent
GET v4/{name=accounts//locations//localPosts/*}. Gets a local post.
Inputs: name (required).
gmb_v4_accounts_locations_localposts_listARead-onlyIdempotent
GET v4/{parent=accounts//locations/}/localPosts. Lists local posts for a location.
Inputs: parent (required), pageSize, pageToken.
gmb_v4_accounts_locations_localposts_patchAIdempotent
PATCH v4/{name=accounts//locations//localPosts/*}. Updates a local post using an update mask.
Inputs: name (required), updateMask (required), body.
gmb_v4_accounts_locations_media_createA
POST v4/{parent=accounts//locations/}/media. Creates a media item from a source URL.
Inputs: parent (required), body.
gmb_v4_accounts_locations_media_deleteADestructiveIdempotent
DELETE v4/{name=accounts//locations//media/*}. Deletes a media item.
Inputs: name (required).
gmb_v4_accounts_locations_media_getARead-onlyIdempotent
GET v4/{name=accounts//locations//media/*}. Gets a media item.
Inputs: name (required).
gmb_v4_accounts_locations_media_listCRead-onlyIdempotent
GET v4/{parent=accounts//locations/}/media. Lists media for a location.
Inputs: parent (required), pageSize, pageToken.
gmb_v4_accounts_locations_media_patchAIdempotent
PATCH v4/{name=accounts//locations//media/*}. Updates media item metadata using an update mask.
Inputs: name (required), body, updateMask.
gmb_v4_accounts_locations_reviews_deletereplyADestructiveIdempotent
DELETE v4/{name=accounts//locations//reviews/*}/reply. Deletes the reply to a review.
Inputs: name (required).
gmb_v4_accounts_locations_reviews_getARead-onlyIdempotent
GET v4/{name=accounts//locations//reviews/*}. Gets a review.
Inputs: name (required).
gmb_v4_accounts_locations_reviews_listARead-onlyIdempotent
GET v4/{parent=accounts//locations/}/reviews. Lists reviews for a location.
Inputs: parent (required), pageSize, pageToken.
gmb_v4_accounts_locations_reviews_updatereplyAIdempotent
PUT v4/{name=accounts//locations//reviews/*}/reply. Creates or updates the reply to a review.
Inputs: name (required), body.
gmb_verify_locations_fetchverificationoptionsA
POST v1/{+location}:fetchVerificationOptions. Reports all eligible verification options for a location in a specific language.
Inputs: location (required), body, fields, $.xgafv, +2 more.
gmb_verify_locations_getvoiceofmerchantstateCRead-onlyIdempotent
GET v1/{+name}/VoiceOfMerchantState. Gets the VoiceOfMerchant state.
Inputs: name (required), fields, $.xgafv, quotaUser, +1 more.
gmb_verify_locations_verifications_completeA
POST v1/{+name}:complete. Completes a PENDING verification. It is only necessary for non AUTO verification methods. AUTO verification request is instantly VERIFIED upon creation.
Inputs: name (required), body, fields, $.xgafv, +2 more.
gmb_verify_locations_verifications_listARead-onlyIdempotent
GET v1/{+parent}/verifications. List verifications of a location, ordered by create time.
Inputs: parent (required), fields, $.xgafv, pageSize, +3 more.
gmb_verify_locations_verifyC
POST v1/{+name}:verify. Starts the verification process for a location.
Inputs: name (required), body, fields, $.xgafv, +2 more.
gmb_verify_verificationtokens_generateB
POST v1/verificationTokens:generate. Generate a token for the provided location data to verify the location.
Inputs: body, fields, $.xgafv, quotaUser, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 72 tools
Most tools are clearly distinct by resource and action, with verbose hierarchical names. However, the presence of both v1 and v4 versions for similar resources (e.g., gmb_info_locations vs. gmb_v4_accounts_locations) and multiple 'get' variants (get vs. getgoogleupdated) could cause some ambiguity.
Tool names generally follow a gmb_<service>_<resource>_<action> pattern with underscores, but there are notable inconsistencies: camelCase action names (fetchMultiDailyMetricsTimeSeries), version prefixes placed differently (gmb_v4_accounts vs. gmb_accounts), and one tool with an auto-generated hash suffix (mo_4ba8b09f).
With 72 tools, this server is far beyond the typical well-scoped MCP server range. The sheer number of endpoints mirrors the full Google Business Profile API, which is too heavy and likely overwhelming for most agent use cases.
The tool surface covers a wide range of Google My Business domains: accounts, locations, admins, invitations, actions, notifications, Q&A, media, local posts, reviews, verification, performance, and lodging. Minor gaps exist (e.g., no singular 'get' for admin entities), but the overall lifecycle coverage is strong.
Maintenance
Related MCP Connectors
Hosted Google Business Profile MCP server: reviews, posts, profile edits, Maps rank. OAuth sign-in.
Hosted Google Business Profile MCP server, with each action switched on or off per account.
Google Ads MCP server — manage campaigns, keywords, and metrics.
Hosted MCP server for GA4, Google Ads and Search Console. Google OAuth, nothing to install.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server to interact with Google produts.492MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that enables interaction with Google's My Business Account Management API, allowing users to perform account management operations through natural language interactions.-
- AlicenseAqualityDmaintenanceMCP server for Google Workspace APIs - Docs, Sheets, Drive, Gmail, and Calendar. Enables reading, creating, and editing Google Docs and Sheets, managing comments, reading emails, and viewing calendar events.3417MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides 40 tools for managing Google Business Profiles, including accounts, locations, verifications, reviews, and performance analytics, enabling AI agents to interact with GBP via REST APIs.5MIT