Log inSubmit server
Google Business Profile MCP logo

Google Business Profile MCP

Manage Google Business Profile locations, reviews, posts, attributes, and performance metrics through MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Google Business Profile MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "google-business-profile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-business@latest"
      ],
      "env": {
        "GOOGLE_BUSINESS_CLIENT_ID": "YOUR_VALUE_HERE",
        "GOOGLE_BUSINESS_CLIENT_SECRET": "YOUR_VALUE_HERE",
        "GOOGLE_BUSINESS_REFRESH_TOKEN": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

Google Business Profile MCP connects AI clients to Google Business Profile account, location, performance, review, and local-post APIs. It supports OAuth login through environment variables or an in-chat browser flow, with tools for inspecting data and making confirmed profile changes. Reach for it when an agent needs to monitor locations, analyze engagement, respond to reviews, publish local posts, or update business information. Google Basic API Access approval and a verified Business Profile are required before API calls can succeed.

Use cases

  • List locations and inspect their profile details
  • Analyze calls, directions, website clicks, and search impressions
  • Draft and publish replies to customer reviews
  • Create or update local event, offer, and standard posts
  • Update location fields and accessibility or payment attributes

Key features

  • OAuth authentication with environment variables or browser login
  • Account, location, category, and attribute management
  • Daily performance and search-keyword reporting
  • Review retrieval and owner-reply management
  • Local post publishing and editing
  • Authenticated raw API requests

Tools26

What Google Business Profile MCP lets your agent do. Expand a tool for its parameters.

Verified live~6.6k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

21/23 checks healthy over the last 92d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · mcp-google-business@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars3Stargazers on the source repository.
npm downloads1.4kPackage downloads in the last 30 days.
Last commit6d agoMost recent push to the default branch.
Tools exposed26Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Google Business Profile MCP works

What Google Business Profile MCP does

Google Business Profile MCP exposes Google Business Profile operations as MCP tools for AI clients. It covers account discovery, location details, categories, attributes, performance reporting, customer reviews, and local posts. Read operations can retrieve profile and engagement data, while write operations can change public business information or content.

The server works across Google's current Business Information, Account Management, and Performance APIs, plus the legacy v4 API that still hosts reviews and local posts. A single business.manage OAuth scope covers these API surfaces.

How it works

Authentication can use GOOGLE_BUSINESS_CLIENT_ID, GOOGLE_BUSINESS_CLIENT_SECRET, and GOOGLE_BUSINESS_REFRESH_TOKEN, or the server's browser-based login flow. auth_status reports the connection state without making a network request or exposing tokens. For interactive setup, start_login returns a URL, a local listener receives Google's redirect, and finish_login stores and verifies the resulting credentials. logout revokes stored credentials and removes the local token file.

Account and location identifiers are used to connect related operations. list_accounts returns account names such as accounts/{id}, while location tools use locations/{id}. The server can list or update location fields and attributes, inspect category metadata, search business chains, and retrieve daily metrics or monthly search-keyword impressions.

Review and post operations use the legacy v4 API. Review tools can list, retrieve, reply to, and remove replies from reviews. Local-post tools can list, create, update, and delete posts, including standard, event, and offer content.

Setup and configuration

Run the npm stdio package with Node.js 20 or newer. It can be added to Codex, Claude Code, Claude Desktop, Cursor, or VS Code using the mcp-google-business@latest package and the three GOOGLE_BUSINESS_* environment variables.

Google Cloud setup requires enabling the Account Management, Business Information, Performance, and legacy Google My Business APIs. The Cloud project also needs Basic API Access approval. Before approval, the API quota is zero; approved projects receive quota for each API. The OAuth client should be a Desktop application, and the consent screen must be published because testing-mode refresh tokens expire after seven days.

The server also supports setup_instructions and set_client for configuring a downloaded OAuth client JSON file. The client is stored in an owner-only shared configuration path, while tokens remain specific to each server.

Tools and capabilities

  • Discover accessible Google Business Profile accounts and locations.
  • Read or update location fields with an explicit update mask, including validation-only checks.
  • Query categories, category-specific attributes, and business-chain information.
  • Retrieve daily performance metrics in single-metric or batched requests.
  • Inspect search-keyword impressions, including low-volume threshold values.
  • List reviews and publish, replace, or delete owner replies.
  • List, create, modify, and delete local posts with calls to action, events, offers, or media.
  • Send authenticated requests to supported Google Business Profile API hosts through raw_request.

Limitations and notes

Google applies a hard limit of 10 edits per minute for each profile. Recent performance data can have a delay of several days, and current-day values may be empty. Review and local-post functionality depends on the legacy v4 API. Review replies require a verified location, and local posts may remain in PROCESSING before becoming live; alert posts are restricted and are typically rejected.

The API limits account pages to 20 results and review pages to 50. Search-keyword counts below Google's reporting threshold are returned as thresholds rather than exact values. The raw_request tool can reach write or delete endpoints, so clients should treat it as potentially destructive. OAuth credentials and refresh tokens should be handled as passwords.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Google Business Profile MCP

Google Business Profile MCP is an MCP server that connects AI clients to Google Business Profile APIs for account and location data, reviews, local posts, categories, attributes, and performance metrics. Its tools can inspect data, update locations, manage review replies, publish posts, and authenticate through OAuth.

Install it as an MCP stdio server with `npx -y mcp-google-business@latest`. Configure the server with the Google OAuth client ID, client secret, and refresh token environment variables, then add the resulting MCP configuration to your client.

Yes, Google Business Profile MCP works with Cursor through a stdio entry in `~/.cursor/mcp.json` or the equivalent Windows path. The configuration runs `npx -y mcp-google-business@latest` and supplies the three `GOOGLE_BUSINESS_*` OAuth variables.

Google Basic API Access approval is required before calls can succeed. The Cloud project must enable the required Business Profile APIs, and the account must access a verified, active Business Profile. Use `auth_status` to inspect OAuth state, scopes, account email, and credential sources.

Yes, it can publish or replace review replies and create, update, or delete local posts. These operations change public content, so the MCP client should obtain confirmation before invoking them. Review and post operations use Google's legacy v4 API.

Related MCP servers

All in Monitoring All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewGoogle Business Profile MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/google-business-profile-mcp?style=directory)](https://allmcps.com/mcp/google-business-profile-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/google-business-profile-mcp"><img src="https://allmcps.com/api/badge/google-business-profile-mcp?style=directory" alt="Google Business Profile MCP on AllMCPs" /></a>