Skip to content
plugmcp
DirectorySkillsCategoriesBlog
EN/中文
Sign inSign up
Home/Servers/Google Business Profile MCP

Google Business Profile MCP

I
by io.github.A1-x-Tech

MCP server for Google Business Profile: locations, reviews, local posts and performance metrics.

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Local command
npx -y [email protected]
Credentials from the publisher
  • GOOGLE_BUSINESS_CLIENT_ID — OAuth2 client id from Google Cloud Console (refresh flow).
  • GOOGLE_BUSINESS_CLIENT_SECRET — OAuth2 client secret. Treat it as a secret.
  • GOOGLE_BUSINESS_REFRESH_TOKEN — OAuth2 refresh token with the business.manage scope. Treat it as a secret.
  • GOOGLE_BUSINESS_ACCESS_TOKEN — Ready-made access token (~1 h) as an alternative to the refresh-flow trio above.
  • GOOGLE_BUSINESS_TIMEOUT_MS — Per-request timeout in milliseconds.
  • GOOGLE_BUSINESS_MAX_RETRIES — 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.
  • GOOGLE_BUSINESS_ACCOUNTS_API_BASE — Account Management API base override.
  • GOOGLE_BUSINESS_INFO_API_BASE — Business Information API base override.
  • GOOGLE_BUSINESS_PERFORMANCE_API_BASE — Business Profile Performance API base override.
  • GOOGLE_BUSINESS_V4_API_BASE — Legacy v4 My Business API base override (reviews, local posts).
Provider
Claude Code
GOOGLE_BUSINESS_CLIENT_ID=<value> GOOGLE_BUSINESS_CLIENT_SECRET=<secret> GOOGLE_BUSINESS_REFRESH_TOKEN=<secret> GOOGLE_BUSINESS_ACCESS_TOKEN=<secret> GOOGLE_BUSINESS_TIMEOUT_MS=<value> GOOGLE_BUSINESS_MAX_RETRIES=<value> GOOGLE_BUSINESS_OAUTH_PORT=<value> GOOGLE_BUSINESS_ACCOUNTS_API_BASE=<value> GOOGLE_BUSINESS_INFO_API_BASE=<value> GOOGLE_BUSINESS_PERFORMANCE_API_BASE=<value> GOOGLE_BUSINESS_V4_API_BASE=<value> claude mcp add io.github.a1-x-tech-mcp-google-business -- npx -y [email protected]

Run in a terminal.

Claude Desktop
{
  "mcpServers": {
    "io.github.a1-x-tech-mcp-google-business": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "GOOGLE_BUSINESS_CLIENT_ID": "<value>",
        "GOOGLE_BUSINESS_CLIENT_SECRET": "<secret>",
        "GOOGLE_BUSINESS_REFRESH_TOKEN": "<secret>",
        "GOOGLE_BUSINESS_ACCESS_TOKEN": "<secret>",
        "GOOGLE_BUSINESS_TIMEOUT_MS": "<value>",
        "GOOGLE_BUSINESS_MAX_RETRIES": "<value>",
        "GOOGLE_BUSINESS_OAUTH_PORT": "<value>",
        "GOOGLE_BUSINESS_ACCOUNTS_API_BASE": "<value>",
        "GOOGLE_BUSINESS_INFO_API_BASE": "<value>",
        "GOOGLE_BUSINESS_PERFORMANCE_API_BASE": "<value>",
        "GOOGLE_BUSINESS_V4_API_BASE": "<value>"
      }
    }
  }
}

claude_desktop_config.json

Step-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Related MCP

View more
  • Firecrawl🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.
  • N
    NotionToken-auth Notion MCP: pages, databases, blocks, comments, files. Runs headless in CI and agents.
  • Context7Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors

Related skills

View all
  • reaReverse engineer anything with agents, from app behavior down to native binaries.
  • rea-changelog-updatePrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.
  • rea-tool-designDesign or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.

MCP server for Google Business Profile: locations, reviews, local posts and performance metrics.

Google Business Profile MCP

English | Русский

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.

Connect the server · Explore use cases · Open technical documentation

See it work in a minute

You: List my locations and show the newest reviews that do not have a reply.

Assistant: Shows the locations and recent reviews. Nothing changes.

You: Draft a reply to the newest three-star review at the downtown location. Apologize and offer to help.

Assistant: Shows the location, review and proposed reply, then asks for confirmation before publishing it.

You: Confirm.

Assistant: Publishes the reply. It does not alter the review, other locations or posts.

Contents

  • Quick start
  • What you can ask it to do
  • What can change
  • Getting access
  • Configuration
  • Data, limits and background work
  • Technical documentation
  • Support

Quick start

You need Node.js 20+, a verified Google Business Profile, a Google Cloud OAuth client and an approved Basic API Access application.

  1. Get approved access.
  2. Add the server to your AI app.
  3. Start with the read-only question above.

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.

codex mcp add google-business \
  --env GOOGLE_BUSINESS_CLIENT_ID=your_client_id \
  --env GOOGLE_BUSINESS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_BUSINESS_REFRESH_TOKEN=your_refresh_token \
  -- npx -y mcp-google-business@latest
codex mcp list

Codex MCP documentation

claude mcp add \
  --env GOOGLE_BUSINESS_CLIENT_ID=your_client_id \
  --env GOOGLE_BUSINESS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_BUSINESS_REFRESH_TOKEN=your_refresh_token \
  --transport stdio --scope user google-business \
  -- npx -y mcp-google-business@latest
claude mcp list

Claude Code MCP documentation

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:

{"mcpServers":{"google-business":{"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"}}}}

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.

Claude Desktop MCP documentation

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

Run MCP: Open User Configuration and add:

{"servers":{"google-business":{"type":"stdio","command":"npx","args":["-y","mcp-google-business@latest"],"env":{"GOOGLE_BUSINESS_CLIENT_ID":"${input:gbp_client_id}","GOOGLE_BUSINESS_CLIENT_SECRET":"${input:gbp_client_secret}","GOOGLE_BUSINESS_REFRESH_TOKEN":"${input:gbp_refresh_token}"}}},"inputs":[{"type":"promptString","id":"gbp_client_id","description":"Google OAuth client ID"},{"type":"promptString","id":"gbp_client_secret","description":"Google OAuth client secret","password":true},{"type":"promptString","id":"gbp_refresh_token","description":"Google OAuth refresh token","password":true}]}

Check it with MCP: List Servers. VS Code MCP documentation

What you can ask it to do

  • 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

OperationWhat happensConfirmation boundary
Accounts, locations, categories, attributes, performance, reviews and postsReads existing profile dataNo change
Update a location or its attributesChanges public business profile dataChanges a location
Reply to a reviewPublishes a public owner replyChanges public content
Create or update a local postPublishes or changes public local contentChanges public content
Delete a review reply or local postRemoves public contentDestructive
Raw API requestMay call any write or delete endpointPotentially 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.

  1. 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.
  2. 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).
  3. 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.
  4. 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

VariableRequiredDescription
GOOGLE_BUSINESS_CLIENT_IDYes*OAuth client ID.
GOOGLE_BUSINESS_CLIENT_SECRETYes*OAuth client secret.
GOOGLE_BUSINESS_REFRESH_TOKENYes*OAuth refresh token with business.manage.
GOOGLE_BUSINESS_ACCESS_TOKENYes*Short-lived alternative to the OAuth trio.
GOOGLE_BUSINESS_TIMEOUT_MSNoPer-request timeout; default 60000 ms.
GOOGLE_BUSINESS_MAX_RETRIESNoTemporary-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. 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.

Technical documentation

  • MCP capability catalog — task-oriented pages for every tool.
  • All tools and inputs
  • Development documentation
  • Publishing documentation
  • Google Business Profile API documentation

Support

Found a bug or need a scenario? Create an issue or write in Telegram.

How do I install Google Business Profile MCP?
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does Google Business Profile MCP need an API key?
The publisher lists these environment variables: GOOGLE_BUSINESS_CLIENT_ID, GOOGLE_BUSINESS_CLIENT_SECRET, GOOGLE_BUSINESS_REFRESH_TOKEN, GOOGLE_BUSINESS_ACCESS_TOKEN, GOOGLE_BUSINESS_TIMEOUT_MS, GOOGLE_BUSINESS_MAX_RETRIES, GOOGLE_BUSINESS_OAUTH_PORT, GOOGLE_BUSINESS_ACCOUNTS_API_BASE, GOOGLE_BUSINESS_INFO_API_BASE, GOOGLE_BUSINESS_PERFORMANCE_API_BASE, GOOGLE_BUSINESS_V4_API_BASE.
What transport does Google Business Profile MCP use?
Google Business Profile MCP runs locally over stdio.
When was Google Business Profile MCP last checked?
Last checked 2026-10-16. MCP server for Google Business Profile: locations, reviews, local posts and performance metrics.

No tool list yet. Remote servers get one after the first health check.

plugmcp

Plug any tool into any agent. MCP servers for people who do not write servers. Gateway for volume, n8n for apps.

  • github.com/TODO
  • x.com/TODO
  • linkedin.com/company/TODO

PlugMCP, 2026

Product
  • Browse
  • Install
  • Host your own
  • Voice mode
  • Browser
Directory
  • All MCP servers
  • Agent skills
  • Categories
  • New
  • Voice
  • Submit a server
Developers
  • Docs
  • Blog
  • What is MCP
  • What is WebMCP
  • Status
Company
  • About
  • Contact
  • Terms
  • Privacy
  • DPA