Google Business Profile MCP Server

An MCP (Model Context Protocol) server that lets AI assistants manage your Google Business Profile — create posts, reply to reviews, list locations, and more.

Built for use with Claude Code, Cursor, and other MCP-compatible AI tools.

Features

Post types

• Standard — text + optional image + optional CTA button (Learn More, Book, Shop, etc.)

• Event — with title, start/end dates and times

• Offer — with coupon code, terms, and redeem URL

Related MCP server: Google Business Profile Review MCP Server

Prerequisites

1. A Google Cloud project with the My Business Business Information API and My Business Account Management API enabled

2. An OAuth 2.0 Client ID (Desktop or Web type) with http://localhost:3456/callback as an authorized redirect URI

3. Your Google account must have access to a Google Business Profile

Setup

1. Clone and install

git clone https://github.com/narkov/gbp-mcp.git
cd gbp-mcp
npm install
npm run build

2. Configure credentials

Copy the example env file and fill in your OAuth credentials:

cp .env.example .env

Edit .env:

GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=GOCSPX-your-secret

3. Authorize with Google (one-time)

npm run auth

This opens a browser for Google OAuth consent. After approval, tokens are saved to credentials/gbp-tokens.json and auto-refresh on subsequent use.

4. Add to your MCP client

Claude Code (.mcp.json)

{
  "mcpServers": {
    "gbp": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/gbp-mcp",
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_CLIENT_SECRET": "GOCSPX-your-secret"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

Same format as above.

Usage examples

Once connected, your AI assistant can:

"List all my GBP locations"
"Create a post on my Kyiv location about a spring sale with a Shop Now button"
"Show me recent reviews and draft replies for negative ones"
"Delete last week's expired offer post"

API reference

This server uses the following Google APIs:

• My Business Account Management API — accounts

• My Business Business Information API — locations

• Google My Business API v4 — posts, reviews, media

License

MIT