Grid My Business MCP Server
Connect your AI tools to Grid My Business using the Model Context Protocol (MCP), an open standard that lets AI assistants interact with your workspace.
https://mcp.gridmybusiness.com/mcp
What is MCP?
The Model Context Protocol (MCP) is an open standard that enables AI models to interact with local and remote data sources. By connecting the Grid My Business MCP server, you give your AI the ability to:
- List your workspaces and browse all Google Business Profiles within them.
- Run a full profile analysis to surface optimisation gaps and actionable insights.
- List tracked keywords, inspect individual keyword details, and pull complete ranking history.
- Analyse competitor profiles and local positioning to understand how you stack up.
- Get AI-powered sentiment analysis across all your customer reviews at a glance.
- Fetch Google Business performance metrics and audit your citation listings.
Connecting to MCP
Each tool has different steps to locate and configure the MCP server. Choose your tool below:
Claude Code
claude mcp add --transport http grid-my-business https://mcp.gridmybusiness.com/mcp
Then run /mcp once you've opened a Claude Code session to go through the authentication flow.
Use the /mcp command to list and manage the MCP servers you have installed, and use the
/context command to understand the context token usage of your current session, including the number of tokens used
by each MCP server that's enabled.
Claude desktop
- Navigate to Settings
- Go to the Developer tab
- Click Edit Config
- Add the configuration code below into your config file (
claude_desktop_config.json):
- Quit Claude desktop and relaunch it to move through the authentication flow.
The setup steps for the MCP server are the same regardless of whether you use the IDE Extension or the CLI since the configuration is shared.
Configuration via CLI
Run the following command in Terminal:
codex mcp add grid-my-business --url https://mcp.gridmybusiness.com/mcp
This will automatically prompt you to log in and connect it to your Codex.
Configuration via app
- Navigate to Settings
- Go to the MCP servers tab
- Click Add server
- Select Streamable HTTP
- Type
grid-my-businessfor the Name - Paste
https://mcp.gridmybusiness.com/mcpinto the URL field - Click Save
- Click Authenticate to move through the authentication flow.
Configuration via environment variables
- Open the
~/.codex/config.tomlfile in your preferred editor - Add the following configuration:
[mcp_servers.gmb] url = "https://mcp.gridmybusiness.com/mcp"
Then run codex mcp login gmb to move through the authentication flow.
- Navigate to Settings
- Go to Tools & MCPs tab
- Click New MCP Server
- Add the configuration code below into your config file (
~/.cursor/mcp.json):
- Navigate to Settings
- Go to Customizations tab
- Click Open MCP Config
- Add the configuration code below into your config file (
~/.gemini/antigravity/mcp_config.json):
-
Open your OpenCode config file (
opencode.jsonin your project root or~/.config/opencode/opencode.jsonfor global settings). - Add the configuration code below under the
mcpkey:
{
"mcp": {
"grid-my-business": {
"type": "remote",
"url": "https://mcp.gridmybusiness.com/mcp",
"oauth": {}
}
}
}
- Restart OpenCode, then run
opencode mcp auth grid-my-businessin your terminal to authenticate. - Verify with
opencode mcp list. Your tools will appear with the prefixgrid-my-business_.
Tools
Every tool is read-only.
| Area | Tools |
|---|---|
| Workspaces and profiles |
list_workspaces list_business_profiles get_business_profile
get_profile_analysis
|
| Keywords | list_keywords get_keyword_detail get_keyword_ranking_history |
| Competitors and citations | list_competitors list_citations |
| Reviews and performance | get_reviews_analysis get_performance_metrics |
| Lead Gen Widget | list_embeds list_embed_leads get_embed_scan_result |
Frequently Asked Questions
Why did authentication fail when I tried to connect?
Most authentication issues are solved by signing out and signing in again. Make sure you are using the same email that you use to log in to Grid My Business, and that your subscription is active. If the popup was closed too early or blocked by your browser, restart the authentication flow from your AI tool.
How many tools does the MCP server have right now?
The MCP server currently provides 14 tools covering workspaces, profile analysis, business profiles, keywords, competitors, review analysis, performance metrics, citations, and the Lead Gen Widget. We add new tools regularly as features become available.
What can the MCP tools do?
All tools are read-only. They let your AI assistant fetch data from your Grid My Business account — things like listing your workspaces and business profiles, pulling keyword ranking history, reviewing competitor performance, or getting review sentiment analysis. None of the tools change, delete, or post anything on your behalf.
Which AI tools work with the MCP server?
Any AI client that supports the Model Context Protocol will work. We provide step-by-step setup for Claude Code, Claude Desktop, Codex, Cursor, Antigravity, and OpenCode above.
Do I need a paid plan to use the MCP server?
You need an active Grid My Business account with access to the data you want your AI to read. The MCP server only returns data from workspaces and profiles you already have permission to view.
Is my data safe when I connect an AI tool?
Yes. You authenticate with your Grid My Business account, and the MCP server only exposes data you already have access to. Because every tool is read-only, an AI assistant cannot make changes to your profiles, reviews, or settings.
The MCP server is not showing up in my AI tool. What should I do?
Double-check that the configuration was saved to the correct file for your tool, then fully restart the app. If you still do not see it, confirm you completed the authentication step — some tools require you to manually trigger login after adding the server.
Why is my AI assistant saying it cannot find my business or keywords?
The AI can only see data that exists in your account. Make sure the business profile or keyword you are asking about has been added to your Grid My Business workspace, and that you are signed in to the workspace that contains it.