Gbp

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

Tool	Description
gbp_list_accounts	List all GBP accounts
gbp_list_locations	List business locations for an account
gbp_create_post	Create a post (standard, event, or offer) with optional photo/video and CTA button
gbp_list_posts	List posts for a location
gbp_get_post	Get details of a specific post
gbp_update_post	Update a post's text or call-to-action
gbp_delete_post	Delete a post
gbp_list_reviews	List reviews for a location
gbp_get_review	Get a specific review
gbp_reply_review	Reply to a review on behalf of the business
gbp_delete_review_reply	Delete a business reply to a review
gbp_list_media	List media (photos/videos) for a location

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

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