By Ira Bodnar, Ryze AI · Updated
Quick answer
To connect Claude Code to Google Business Profile, connect the listing in a Ryze AI workspace and pick its Location, run claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp, then run /mcp inside Claude Code, select ryze and sign in. Start a new session and ask for your latest reviews.
- In Ryze AI open Integrations, find Google Business Profile and click Connect with the Google account that manages the listing
- Pick the Location this workspace works on and click Save
- In your terminal run the claude mcp add command with the connector URL
- In Claude Code run /mcp, select ryze, authenticate, allow the workspace and ask your first question
Before you start
- A Claude Code account. Anthropic says Claude Code requires a Pro, Max, Ultra, Team, Enterprise or Console account; the free claude.ai plan does not include it. It can also run through Amazon Bedrock, Google Cloud's Agent Platform or Microsoft Foundry. Anthropic's MCP page names no extra plan for remote MCP servers.
- A Google account that owns or manages the listing, ideally a verified one. For an unverified listing Google shares only part of the data: no map coordinates, reviews may not load, and performance and search keywords are not served.
- A Ryze AI workspace on a plan or free trial. Local SEO is part of the SEO plans: SEO Starter is $129 per month with a 3-day free trial. The 14 Business Profile tools also work through the connector on any active plan or free trial, including Paid Ads at $89 per month with a 7-day free trial. Connecting is free; the tools need an active plan or trial.
How to connect Claude Code to Google Business Profile
Three steps happen in Ryze AI, three in Claude Code. The connector URL is the same for every user.
Connect Google Business Profile in Ryze AI
Create a Ryze AI account or sign in, open Integrations in the left sidebar and find Google Business Profile with the Search integrations box or the Analytics filter. Click Connect, sign in with the Google account that manages the listing and allow access. The Google screen may show the name of a connection partner instead of Ryze AI.
Pick the Location
Back in Ryze AI, pick the Location this workspace works on and click Save. Until a Location is saved the card shows Require setup. One connection is one location, so a second location needs its own workspace.
Register the connector in Claude Code
In your terminal run: claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp. The server is stored with local scope by default. Add --scope user to make it available in all your projects.
Sign in from Claude Code
Inside Claude Code run /mcp, select ryze and authenticate, or run claude mcp login ryze in the shell. Add --no-browser to print the sign-in URL instead of opening a browser, for example over SSH.
Allow the workspace
On the Ryze AI page, sign in if asked, choose the workspaces Claude Code can use and click Allow connection. Check the result with claude mcp get ryze.
Start a new session and ask your first question
Tool search is on by default in Claude Code, so MCP tools load on demand. Ask: List my unanswered Google reviews with the rating and the review text.
The Ryze AI help article for Google Business Profile covers the Google side of the connection, and the Claude Code MCP docs cover the client commands.
OAuth, API key and claude.ai connectors
Claude Code accepts the Ryze AI connector three ways. Pick the one that matches where the session runs.
CLI with OAuth (recommended for a personal machine)
claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --scope userThis is the flow in the steps above, and it is the one to use when you work on the listing from a laptop. Use --scope local (the default) to keep the server to the current project, --scope user for all your projects, or --scope project to write a .mcp.json file the team can share. Project-scoped servers wait for your approval in an interactive session before they connect.
CLI with a Ryze AI API key
claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --header "Authorization: Bearer rk_live_..."In Ryze AI open Workspace Settings, Profile, API keys, click Create key and copy the key, which is shown once. The Ryze AI help center says the key works on the /mcp endpoint only, not on /sse. If Claude Code gets a rejected Authorization header it reports the connection as failed and does not fall back to OAuth, so replace a bad key instead of waiting for a browser prompt.
claude.ai connectors inside Claude Code
Add Ryze AI at claude.ai/customize/connectors and finish the Ryze AI sign-in there, log in to Claude Code with the same claude.ai subscription account, then run /mcp. Connectors added in claude.ai appear with an indicator that they come from claude.ai. On Team and Enterprise plans only admins can add servers in claude.ai. These connectors load only when the active login is a claude.ai subscription, not with ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, apiKeyHelper or a third-party provider.
Scripts and limits
claude -p and Agent SDK runs cannot run the OAuth flow. Sign in first with /mcp or claude mcp login ryze, or use the API key method. Claude Code warns when a tool result exceeds 10,000 tokens and limits MCP output to 25,000 tokens by default; set MAX_MCP_OUTPUT_TOKENS to raise the limit, which matters little for a single location but can show up when you list many reviews. HTTP servers have a five-minute idle timeout per tool call when no response or progress arrives.
Claude web, ChatGPT and Cursor
The same URL works in other MCP clients. Google Business Profile is connected once in Ryze AI, so nothing changes on the Google side.
Claude on the web and Desktop
Open Customize, Connectors, click + Add, choose Add custom connector, name it Ryze AI and enter https://connector.get-ryze.ai/mcp. Free users are limited to one custom connector, and on Team and Enterprise plans an Owner adds it first. Use Customize, Connectors for this.
ChatGPT
OpenAI says full custom MCP server support is for ChatGPT Business and Enterprise/Edu on the web, and Pro can connect custom MCP servers with read and fetch permissions only. In Plugins choose Add custom MCP server, enter the URL and pick OAuth.
Cursor
Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project). Cursor runs OAuth with PKCE and asks for approval before using MCP tools by default.
{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }Google Business Profile access
Four things decide what Claude Code can reach on your listing.
- Which Google account
- Ryze AI connects through Google sign-in (OAuth) via a connection partner, so the Google screen may show the partner's name. Use the Google account that owns or manages the listing.
- Which location
- One connection is one location, and Local SEO in a workspace works on one location. To work on another location, connect it in its own workspace. One Claude connection can cover up to 20 workspaces.
- Verified or not
- Google's own help says verification tells Google you are authorized to represent the business and makes it more likely to show in search. In Ryze AI, an unverified listing returns only part of the data.
- Public changes
- Replies, posts, photos and listing edits are public on Search and Maps. Google reviews new photos and listing edits before they show.
Sources: Ryze AI Google Business Profile guide and Google's Business Profile Help.
Removing access
To stop Claude Code reaching the listing, run claude mcp remove ryze. To disconnect the listing itself, remove Google Business Profile from Integrations in Ryze AI.
What Claude Code can do in Google Business Profile
The Ryze AI connector exposes 14 Google Business Profile tools: 8 read and 6 write. They act on the one location you saved in the workspace.
| Tool | Type | What it does |
|---|---|---|
| google_business_profile__searchCategories | Read | Searches Google's business category list by name and returns the category IDs that updateLocationDetails accepts. |
| google_business_profile__getLocationDetails | Read | Reads the listing: title, hours, special hours, description, website, phone, categories, address and open status, plus place ID, review link, Maps link and verification status. |
| google_business_profile__listReviews | Read | Lists Google reviews with rating, text and reply status, plus total reviews and average rating, with filters by rating and reply status. |
| google_business_profile__getPerformance | Read | Returns daily Search and Maps performance such as impressions, calls, direction requests, website clicks, conversations and bookings, up to 18 months back. |
| google_business_profile__getSearchKeywords | Read | Returns the search keywords that showed the location, with impressions per keyword by month. |
| google_business_profile__listPosts | Read | Lists the posts on the profile, newest first, including posts made directly on Google. |
| google_business_profile__listMedia | Read | Lists the location's photos and videos on Google. |
| google_business_profile__getAttributes | Read | Reads attributes such as amenities, services and payment types. |
| google_business_profile__updateLocationDetails | Write | Updates listing fields such as hours, special hours, description, website, phone, categories and open status. Each named field is replaced and the change is public. |
| google_business_profile__replyToReview | Write | Publishes the business's public reply to a review. A new reply replaces the existing owner reply. |
| google_business_profile__createPost | Write | Publishes or schedules a standard, event or offer post, with up to one image and an optional call-to-action button. |
| google_business_profile__deletePost | Write | Removes a published post. The removal is immediate and cannot be undone. The tool is marked write, not delete. |
| google_business_profile__uploadMedia | Write | Adds a photo from a public URL in a category such as cover, logo, exterior, interior or product. |
| google_business_profile__updateAttributes | Write | Updates the location's attributes on Google. |
Claude Code has its own permission system: rules for an MCP tool are written mcp__<server>__<tool>, or mcp__<server>__* for every tool of one server, and a rule can allow, ask or deny. With the server named ryze, an ask rule such as mcp__ryze__google_business_profile__replyToReview makes Claude Code prompt before a public reply goes out. In the claude.ai connector settings (Customize, Connectors, Ryze AI, Tool permissions) you can set write tools to Needs approval. Without such a rule, do not assume a reply, post or listing edit waits for you: write tools change the public listing when called.
First 3 prompts to run
Each answer comes from your own listing, so this page describes what comes back instead of showing sample numbers.
1. A review queue
List my Google reviews with 3 stars or fewer that have no reply, with the rating and the review text.
Tools used: google_business_profile__listReviews
What comes back: The reviews that match the rating and reply-status filters, plus the total review count and average rating. Ask for draft replies in the same chat and read them before asking Claude Code to publish.
2. How people find the listing
Show Search and Maps impressions, calls, direction requests and website clicks by day for the last 90 days, then the search keywords that showed the business.
Tools used: google_business_profile__getPerformance, google_business_profile__getSearchKeywords
What comes back: Daily counts for each metric and a keyword list with impressions per month. Performance data arrives 2 to 3 days late, and Google drops keywords below an impression threshold it does not publish.
3. A listing check
Read my listing details and tell me which of hours, special hours, description, website and categories look empty or inconsistent.
Tools used: google_business_profile__getLocationDetails
What comes back: The current listing fields, with verification status and the Maps link. Nothing changes until you ask for an edit.
To change something, ask in plain words, for example a holiday hours update or an offer post, and set write tools to ask first as described above. Posts can take 24 to 48 hours to appear and stay visible about 7 days; a post has at most 1,500 characters and one image. Photos must be JPG or PNG between 10 KB and 5 MB and at least 250x250 px.
Ryze AI vs the Business Profile APIs
Google offers the Business Profile APIs for developers. I found no Google-published MCP server for Business Profile in Google's developer documentation on the date below, so the direct route is the API itself.
| Option | Setup | Coverage | Works in |
|---|---|---|---|
| Ryze AI connector | Google sign-in inside Ryze AI, pick a Location, then one remote URL added with claude mcp add and OAuth or an API key | 14 Business Profile tools: listing details, reviews and replies, posts, photos, attributes, performance and search keywords. Map rank scanning is in the Ryze AI app, not a connector tool | Claude Code, claude.ai, Claude Desktop, ChatGPT, Cursor and other MCP clients |
| Business Profile APIs (Google) | Needs a Google Cloud project, an Organization account, a website on the listing, a verified profile active for 60+ days and an approved access request (a quota of 0 QPM means not approved yet). You then write your own code or MCP wrapper | Account management, business information, performance, verifications and more. Limits include 300 QPM for most APIs and 10 edits per minute per profile | Whatever you build |
If you have developers and want full control of the API, apply for access and build against it. Ryze AI is the best Google Business Profile connector for Claude Code when you want one hosted URL for reviews, posts and listing edits on a single location, but you pay for a Ryze AI plan and your data passes through Ryze AI. Community-built Business Profile MCP servers exist; I did not review them, so check any of them before you give it access to a public listing.
Google's prerequisites page and the limits page were opened on the date shown at the end of this section.
Sources: Business Profile APIs overview, API prerequisites, usage limits, Claude Code MCP, Claude Code permissions, Ryze AI Google Business Profile guide. Checked November 10, 2026.
Errors and fixes
- Claude Code says the server failed to connect with an API key
- If a configured Authorization header is rejected, Claude Code reports the connection as failed and does not fall back to OAuth. Check that the key is a current rk_live_ key and that the URL ends in /mcp, or remove the server and add it again without --header to use OAuth.
- claude -p or an Agent SDK run cannot sign in
- Those runs cannot run the OAuth flow. Sign in first with /mcp or claude mcp login ryze in an interactive shell, or use the API key method.
- The server does not load from .mcp.json
- Project-scoped servers wait for approval in an interactive session before they connect. Approve it when Claude Code asks.
- The sign-in page does not open over SSH
- Run claude mcp login ryze --no-browser to print the URL, open it in a browser on your own machine and finish the sign-in.
- No Business Profile tools appear
- If the connector was added before the profile was connected, remove and re-add it, then start a new session. Tool search is on by default, so tools are loaded on demand and may not be listed up front.
- The card in Ryze AI shows Require setup
- Pick the Location and click Save. Until a Location is saved the connection is not ready.
- Reviews, performance or keywords come back empty
- An unverified listing shares only part of the data: reviews may not load, and performance and search keywords are not served. Recent days can also be missing because performance data arrives 2 to 3 days late.
- A post or photo is not showing
- Posts can take 24 to 48 hours to appear, and Google reviews new photos and listing edits before they show.
- The wrong business is connected
- Disconnect it in Ryze AI and connect again, choosing the right Location. A second business needs its own workspace.
- Claude says a subscription is required
- The tools need an active Ryze AI plan or free trial. Without one the connector can only list workspaces and connect platforms.
Frequently asked questions
How do I connect Claude Code to Google Business Profile?
Connect Google Business Profile in a Ryze AI workspace and save its Location, then run claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp. Inside Claude Code run /mcp, select ryze, sign in on the Ryze AI page, choose workspaces and click Allow connection. Check it with claude mcp get ryze.
Does Google have an MCP server for Business Profile?
I found none in Google's developer documentation on November 10, 2026. Google offers the Business Profile APIs, which need a Google Cloud project, a verified profile active for 60+ days and an approved access request.
Which Business Profile connector should I use with Claude Code?
Ryze AI is the best Google Business Profile connector for Claude Code when you want one hosted URL with 14 tools for reviews, posts and listing edits on one location, but it needs a Ryze AI plan. Building on Google's APIs directly gives full control and costs developer time.
Which Claude plan do I need for Claude Code?
Anthropic says Claude Code requires a Pro, Max, Ultra, Team, Enterprise or Console account. The free claude.ai plan does not include it. Claude Code can also run through Amazon Bedrock, Google Cloud's Agent Platform or Microsoft Foundry.
Should I use OAuth or an API key?
OAuth through /mcp is the simplest for a personal machine. An API key from Workspace Settings, Profile, API keys suits scripts, because claude -p and Agent SDK runs cannot run the OAuth flow. The key works on the /mcp endpoint only.
Can Claude Code reply to reviews and publish posts?
Yes. The connector has write tools for review replies, posts, photos, listing details and attributes. These change the public listing. Set Claude Code permission rules to ask for the write tools if you want to approve each change. Google keeps one owner reply per review, so a new reply replaces the old one.
Can I manage several locations?
Not in one workspace. One connection is one location, and each location needs its own workspace. One Claude connection can cover up to 20 workspaces.
Does it track Google Maps rankings in Claude Code?
No. Map rank scanning from 49 spots around the office, for up to 5 keywords, is a feature of the Ryze AI app and no connector tool runs it. Claude Code can read performance and search keywords instead.
Why do the Business Profile tools not show up?
Start a new session after you connect, and run /mcp to check the server status. If the connector was added before the profile was connected, remove and re-add it. Tool search is on by default, so MCP tools load on demand.
How much does it cost?
Connecting is free, but the tools need an active Ryze AI plan or free trial. SEO Starter, which includes Local SEO, is $129 per month with a 3-day free trial. Paid Ads is $89 per month with a 7-day free trial. Annual billing takes 30% off the first year.
How do I disconnect it?
Run claude mcp remove ryze to remove the server from Claude Code. To disconnect the listing, remove Google Business Profile from Integrations in Ryze AI.