Google Business Profile MCP

Google Business Profile MCP server for Claude Code, Cursor, Copilot and five more AI agents. Connect Google Business Profile to Claude, Copilot, Cursor, Codex, Gemini, Windsurf, Continue.dev and Cline. One extension, 8 agents, no config files to edit.

Install. Sign in with Google. Ask your AI agent about Google Business Profile.

Quick Start

Install from the VS Code Marketplace or Open VSX
Authenticate: the setup wizard appears on first launch
Ask your AI agent anything about Google Business Profile

"How many calls and direction requests did my store get last month?"
"Which search terms showed my business on Google Maps?"
"List my locations and their addresses"

Prerequisites

You need one of these (the wizard will guide you):

Method	Best For	What You Need
OAuth (recommended)	Personal Google accounts	A Google Cloud project with OAuth credentials
ADC	Developers with `gcloud` CLI	Run one terminal command
Service Account	Workspace admins and servers	A JSON key file

Go to Google Cloud Console
Create a project (or select an existing one)
Enable the My Business Account Management API, the My Business Business Information API and the Business Profile Performance API under APIs & Services > Library
Create OAuth credentials:
- Go to APIs & Services > Credentials
- Click Create Credentials > OAuth client ID
- Application type: Desktop app
- Copy the Client ID and Client Secret
Configure the OAuth consent screen (if prompted) and add yourself as a test user
In the extension wizard, select "OAuth" and paste your Client ID and Secret
A browser window opens: sign in with your Google account and authorize

Option B: Application Default Credentials

gcloud auth application-default login \
  --scopes=https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/business.manage

Option C: Service Account Key

Create a service account in Google Cloud Console and give it access to your Google Business Profile data
Download the JSON key file
In the extension wizard, select "Service Account" and pick the file

Google gives the Business Profile APIs to approved projects only. Request access with the Business Profile API contact form before setup; until Google approves it, calls return a quota or permission error. The signed-in Google account must own or manage the profiles.

Available Tools (8)

Tool	What It Does	Example Prompt
`gbp_list_accounts`	Business Profile accounts you manage	"Which business accounts do I have?"
`gbp_list_locations`	Locations with address, phone and category	"List my locations"
`gbp_daily_metrics`	Daily impressions, calls, clicks and direction requests	"Calls per day last month"
`gbp_search_keywords`	Search terms that showed the business, by month	"What do people search to find us?"
`gbp_list_reviews`	Reviews with ratings, text and replies	"Which reviews have no reply yet?"
`gbp_list_posts`	The location's posts	"List our recent posts"

GBP Admin (`gbp_admin`)

One tool, called with an action and its params.

Action	Needs `confirm: true`
`update_location(location, title?, phone?, website?, description?, regular_hours?)`	No
`create_post(location_name, summary, action_type?, action_url?)`	No
`delete_post(post_name)`	Yes
`reply_to_review(review_name, comment)`	No
`delete_review_reply(review_name)`	Yes

Safety

Actions that delete, remove, replace or publish need confirm: true in their params. Without it the server changes nothing and returns a warning, so your AI agent has to ask you and then call again with confirm: true.

Supported AI Agents

The extension auto-registers with every AI agent it detects:

Agent	How It Registers	Config File
VS Code Copilot	VS Code API (automatic)	--
Claude Code	`~/.claude.json`	JSON
Cursor	`~/.cursor/mcp.json`	JSON
OpenAI Codex	`~/.codex/config.toml`	TOML
Google Gemini	`~/.gemini/settings.json`	JSON
Windsurf	`~/.codeium/windsurf/mcp_config.json`	JSON
Continue.dev	`~/.continue/config.yaml`	YAML
Cline	VS Code globalStorage	JSON

You can toggle individual agents on/off in Settings > search googleBusinessProfileMcp.agents.

Settings

Setting	Default	Description
`googleBusinessProfileMcp.authMethod`	`"oauth"`	Auth method: oauth, adc, serviceAccount
`googleBusinessProfileMcp.agents.*`	`true`	Per-agent registration toggles
`googleBusinessProfileMcp.registrationScope`	`"global"`	Global or workspace registration
`googleBusinessProfileMcp.autoStart`	`true`	Auto-start server on VS Code launch
`googleBusinessProfileMcp.serverLogLevel`	`"info"`	Server log verbosity

Commands

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for:

Command	What It Does
`Google Business Profile MCP: Setup Authentication`	Run the setup wizard
`Google Business Profile MCP: Register with AI Agents`	Re-register with all detected agents
`Google Business Profile MCP: Show Status`	Show auth method and server state
`Google Business Profile MCP: Restart MCP Server`	Restart the background MCP server
`Google Business Profile MCP: Check Authentication Status`	Verify credentials are valid
`Google Business Profile MCP: View Server Logs`	Open the output channel for debugging
`Google Business Profile MCP: Remove from All Agents`	Clean up all agent registrations

Troubleshooting