Opengmb MCP

What opengmb-mcp does

opengmb-mcp exposes OpenGMB’s Google Business Profile operations to MCP-compatible clients. It supports work across multiple locations, including reading reviews, drafting and submitting replies, creating and scheduling posts, editing profile details, checking location health, retrieving performance data, and running local rank tracking.

The community edition is self-hosted and communicates with Google through the official Business Profile API. It also includes OpenGMB functions such as review assignments and notes, approval queues, reports, review-request links, location groups, REST API access, outgoing webhooks, and an append-only audit log.

How it works

An MCP client connects to the /mcp endpoint with an API token. OpenGMB routes requests from the web application, MCP server, REST API, and background worker through the same action executor. Permissions, guardrail checks, approvals, and audit logging therefore apply regardless of which interface initiates an action.

Tokens can be read-only or read-write. A human-in-the-loop token can create and submit drafts but cannot approve or publish them. Posts and profile edits require approval. Replies to one- through three-star reviews always require a person, while replies to four- and five-star reviews can be auto-approved only when the owner enables that option for the client.

Guardrails inspect replies, posts, and edits for items such as links, contact details, offers, unsuitable hours, and banned words. Blocking rules cannot be overridden, and warnings must be acknowledged. The checks run again immediately before content is sent to Google.

Setup and configuration

The community edition runs with Docker Compose. Docker Engine 24 or newer, the Compose plugin, and about 4 GB of free RAM during image builds are required. A public HTTPS hostname is needed for Google sign-in.

Clone the repository, enter deploy/selfhost, copy .env.example to .env, and set the owner email and password before starting the stack:

git clone https://github.com/synectus/OpenGMB.git
cd OpenGMB/deploy/selfhost
cp .env.example .env
docker compose up -d --build

The web interface is available at http://localhost:8080. Two-factor sign-in is required, so an authenticator app and backup codes are needed. The Google connection initially supports a sample account and mock data. Live use requires approval for Business Profile API access in a Google Cloud project.

After signing in, create an API token under Settings → API tokens. A Claude Code connection can use the streamable HTTP endpoint with a bearer token:

claude mcp add --transport http opengmb https://your-mcp-host/mcp \
  --header "Authorization: Bearer sgmb_your_token"

Tools and capabilities

• List and review Google reviews across locations.
• Draft, submit, and manage review replies.
• Create, schedule, and approve location posts.
• Edit hours, categories, and services across locations.
• Retrieve calls, website clicks, direction requests, impressions, and monthly search terms.
• Run profile-health checks and identify changes made outside OpenGMB.
• Track local rankings on a geographic grid using a DataForSEO account.
• Generate AI drafts for replies, posts, and descriptions with an Anthropic key.
• Use approval queues, location groups, reports, webhooks, and audit records.