Skip to content
MCP server

Google Business Profile MCP

Manage Google Business Profile locations, reviews, posts and performance by chat

Runs locallyStatus and history
Pricing
Open source
Platforms
vscode, CLI, self-hosted
Runs
Locally
Version
26.11.14
Listing updated
3 days ago

About Google Business Profile MCP

Google Business Profile MCP is an open-source MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.

Reporting is the strong point: gbp_daily_metrics returns impressions on Search and Maps, calls, website clicks and direction requests per location, and gbp_search_keywords lists the monthly search terms that surfaced a profile. An agency with twenty locations can ask for a month-over-month table in one request.

Six read tools cover accounts, locations, metrics, keywords, reviews and posts. A seventh, gbp_admin, edits a location's name, phone, website, description or hours, publishes posts, and replies to reviews. Deleting a post or a review reply needs confirm: true.

Your Google Cloud project needs Google's approval for the Business Profile APIs before any call works. It installs as a free MIT extension for eight agents, or runs from npm.

Install

Run in a terminal

claude mcp add google-business-profile-mcp --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-business-profile-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "google-business-profile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-business-profile-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "google-business-profile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-business-profile-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "google-business-profile-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-business-profile-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "google-business-profile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-business-profile-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "google-business-profile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-business-profile-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

Configuration

  • GOOGLE_APPLICATION_CREDENTIALSPath to a service account key or authorized_user JSON file. Optional if you use gcloud Application Default Credentials or the OAuth variables.
  • GOOGLE_OAUTH_CLIENT_IDOAuth client ID. Set together with the client secret and refresh token.
  • GOOGLE_OAUTH_CLIENT_SECRETOAuth client secret.
  • GOOGLE_OAUTH_REFRESH_TOKENOAuth refresh token with the Business Profile scopes.

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

gbp_list_accounts
Lists the Business Profile accounts you manage.
gbp_list_locations
Lists locations with address, phone, website and categories.
gbp_daily_metrics
Daily performance for a location over a date range.
gbp_search_keywords
Monthly search terms that showed the location.
gbp_list_reviews
Lists reviews with ratings, text and replies.
gbp_list_posts
Lists posts on a location.
gbp_admin
Updates locations, creates and deletes posts, replies to reviews.

What it does

Daily performance
Impressions, calls, clicks and direction requests per location.
Search keywords
Monthly terms that showed the profile.
Review replies
Reads reviews and posts replies.
Location edits
Updates hours, phone, website and description.
Confirmed deletes
Post and reply deletion requires confirm.

Good for

  • Produce a monthly local report
  • Find which searches grew
  • Spot a location that lost impressions
  • Publish a holiday offer post
  • Update Saturday hours

Pricing

Open source

Free and MIT licensed

Prices change. Check renzojohnson.com before you buy.

Google Business Profile MCP FAQ

Why might calls fail after setup?

The Google Cloud project needs approval for the Business Profile APIs.

Is it official?

No, it is independent and uses your own sign-in.

Is it free?

Yes, MIT licensed.

Is Google Business Profile MCP free?

Yes. Google Business Profile MCP is open source, so you can use and self-host it for free.

How do I add Google Business Profile MCP to Claude Code?

Run this command in your terminal: claude mcp add google-business-profile-mcp --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-business-profile-mcp

What are the best alternatives to Google Business Profile MCP?

The closest alternatives to Google Business Profile MCP are Google Ads + Meta Ads + SEO/GEO MCP, Calven, MCP, Red Center Studio free tools and ASOScan.

Alternatives to Google Business Profile MCP

  1. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  2. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  3. MCP

    MCP server

    MCP server for planning, scheduling and measuring social and ad campaigns with approvals

    • Remote
    • Freemium
    • Marketing and SEO
  4. Free website checks for AI readiness, DNS dependencies, domain health and Bubble errors

    • 5 tools
    • Remote
    • Free
    • Marketing and SEO
  5. ASOScan

    MCP server

    ASO data for your own iOS and Android apps: rankings, keywords, reviews, scores

    • Remote
    • Free trial
    • Marketing and SEO
  6. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO