Connect Claude to Google Business Profile via MCP

What do I need before I start?

• An OpenGMB account with your Google account connected and at least one location imported. New accounts get a 14-day trial with $0.50 of credit, no card.
• A client that can reach a remote MCP server over HTTP. The steps below cover Claude Code, Claude Desktop and Cursor, plus the plain values for any other client.
• Node.js on your computer, for Claude Desktop only. It connects through a small bridge called mcp-remote.
• The server address is https://opengmb.synectus.com/mcp. It must be HTTPS because your token travels in a header.

How do I create a token?

1. Open Settings, then API tokens (/settings/tokens) in the app.
2. Give the token a name you will recognize, such as "Claude on my laptop".
3. Choose the access. Read only can look but never change anything. Read & write can also run write tools, with the rights of the person who owns the token.
4. Select Create token and copy it right away. It is shown once and cannot be recovered.

Some roles are limited. A client viewer can only have read only tokens. A client approver's write token can only approve or reject replies. Revoke a token at any time and anything using it stops working. The tokens table shows when each one was last used. Details are on the API tokens page.

How do I connect my client?

Replace <token> with the token you just copied.

Claude Code

One command adds the server. Checked against Claude Code's docs on 2026-10-24: code.claude.com/docs/en/mcp.

claude mcp add --transport http opengmb https://opengmb.synectus.com/mcp --header "Authorization: Bearer <token>"

Then ask Claude a question about your reviews, as in the examples further down.

Claude Desktop

Claude Desktop starts local programs, so it reaches a remote server through the mcp-remote bridge. Open its settings, choose Developer, then Edit Config, add this to claude_desktop_config.json and restart Claude Desktop. Checked against Claude Desktop's docs on 2026-10-24: modelcontextprotocol.io/docs/develop/connect-local-servers.

{
  "mcpServers": {
    "opengmb": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://opengmb.synectus.com/mcp",
        "--header",
        "Authorization: Bearer <token>"
      ]
    }
  }
}

Cursor

Cursor takes a remote server as a URL plus headers in its mcp.json file. Checked against Cursor's docs on 2026-10-24: cursor.com/docs/context/mcp.

{
  "mcpServers": {
    "opengmb": {
      "url": "https://opengmb.synectus.com/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

ChatGPT and other clients

Any MCP client that supports streamable HTTP and lets you set a request header can connect with these values. We have not checked ChatGPT's connector documentation, so look for where it asks for a URL and a header. If its connector screen on your plan has no place for a custom header, it cannot connect to OpenGMB yet.

URL: https://opengmb.synectus.com/mcp
Transport: streamable HTTP
Header: Authorization: Bearer <token>

The endpoint is stateless and takes POST requests only, so opening the address in a browser returns a 405 error. That is normal.

What can the agent do?

Reading is direct. Writing follows one of two paths. Until per-token agent modes ship, a Read & write token acts with its owner's rights: some actions return a proposal, and others, such as approving a reply, run straight away. You choose how much your agent can do by choosing the token's access and which person owns it.

An agent's call is billed like a person's. Google Business Profile calls are free, with a fair-use limit on each account, and the credit pays only for AI drafts and rank scans. The $10 a month is that credit. See billing and credits.

Resources the agent can open

• review-queue (opengmb://reviews/queue): Replies pending approval, blocked or conflicted, and posts pending approval or blocked. Needs the review:approve permission.
• google-pending-updates (opengmb://google/pending-updates): Open profile changes: edits made outside OpenGMB and updates Google suggested. Needs the location:read permission.
• audit-recent (opengmb://audit/recent): The last 100 audit rows. Needs the audit:read permission.

What can I ask Claude to do?

Try these once the server is connected. The note under each one says what it needs.

More on what each tool does is in the Google Business Profile MCP server overview.

What if something goes wrong?

What should I read next?

• MCP tools referenceEvery tool the server exposes, with its inputs and whether it needs a Read & write token.

Related: approvals and guardrails, billing and credits, Google review management and how the Google Business Profile API works.