By Ira Bodnar, Ryze AI · Updated · Connector tested November 13, 2026
Quick answer
The main way to connect Hermes Agent to Google Business Profile is the Ryze AI connector. Connect the listing in a Ryze AI workspace and save its Location. Then add https://connector.get-ryze.ai/mcp under mcp_servers in ~/.hermes/config.yaml with auth: oauth, run hermes mcp login ryze, click Allow connection on the Ryze AI page and run /reload-mcp or start a new session. Hermes Agent then lists the 14 Business Profile tools.
- In Ryze AI open Integrations, click Connect on Google Business Profile and sign in with the Google account that manages the listing
- Pick the Location this workspace works on and click Save
- Add a ryze entry with the connector URL and auth: oauth under mcp_servers in ~/.hermes/config.yaml
- Run hermes mcp login ryze, click Allow connection on the Ryze AI page, then run /reload-mcp
Hermes Agent to Google Business Profile at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector, saved in Hermes Agent as a remote MCP server named ryze |
| Server address | https://connector.get-ryze.ai/mcp, set as url: under mcp_servers in ~/.hermes/config.yaml |
| Sign-in | OAuth with auth: oauth, completed by hermes mcp login ryze. A Ryze AI API key in an Authorization header is the other route |
| Business Profile tools | 14 in all: 8 that read and 6 that write. Removing a post counts as a write |
| Can it change the listing | Yes. Replies, posts, photos, attributes and listing fields go public on Search and Maps. tools.exclude on the ryze entry keeps chosen tools away from the agent |
| Whose sign-in the agent uses | The one you complete with hermes mcp login, cached on the machine that runs Hermes Agent |
| Locations | One connection is one location, and every tool works on the Location saved for it |
| Hermes Agent plan | None to buy. Hermes Agent is open source and self-hosted, and its GitHub repository lists the MIT license |
| Ryze AI price | SEO Starter, which includes Local SEO, is $129 per month with a 3-day free trial. Paid Ads at $89 per month with a 7-day free trial also runs the 14 tools. Connecting is free |
| Google's own option for Hermes Agent | Google lists none: its pages named no Business Profile MCP server for any assistant on November 14, 2026. Its direct route is the Business Profile APIs, closed until Google approves an access request |
| Last tested | The connector's sign-in answer on November 13, 2026, and 11 Business Profile tool calls from Claude Code on November 14, 2026. No step was run inside Hermes Agent |
Before you start
- Hermes Agent. It is open source and self-hosted by Nous Research, with no plan tier. MCP support ships with the standard install, so there is no extra package to add. You need a terminal on the machine that runs it and write access to ~/.hermes/config.yaml.
- 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.
- A note on testing. Ryze AI has no help-center page for Hermes Agent and has not tested the connector there. The steps below follow Nous Research's MCP documentation for remote servers that use OAuth, as it read on November 16, 2026.
How to connect Hermes Agent to Google Business Profile
Two steps happen in Ryze AI and Google, the rest in Hermes Agent. 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, and the tools act on the Location you save here.
Add the connector to config.yaml
Open ~/.hermes/config.yaml and add a ryze entry under mcp_servers with url set to https://connector.get-ryze.ai/mcp and auth set to oauth, as in the block below. Do this before signing in. Hermes Agent's docs warn that editing config.yaml inside a running session reloads MCP connections with a 30 second timeout, which is too short for an interactive OAuth flow.
mcp_servers: ryze: url: "https://connector.get-ryze.ai/mcp" auth: oauthSign in with hermes mcp login
Run: hermes mcp login ryze. Hermes Agent prints an authorize URL and opens the browser when it can. Sign in on the Ryze AI page if asked, choose the workspace that holds your Google Business Profile connection and click Allow connection.
Finish the sign-in on a headless host if needed
On a server without a browser, open the printed authorize URL on another machine. Hermes Agent's docs say an interactive terminal also prints a line to paste the redirect URL, so copy the address the browser ends on and paste it at the prompt.
Reload and ask your first question
Start a new session or run /reload-mcp, which reloads the servers from config.yaml and refreshes the tool list. Then ask: List my Google reviews that have no reply, with the rating and the review text.
The Ryze AI help center article for Google Business Profile covers the Google side of the connection. The Hermes Agent side is covered by its MCP guide and GitHub repository.
Sources: Hermes Agent: MCP configuration, Hermes Agent on GitHub (checked November 16, 2026).
config.yaml, hermes mcp login and API key
config.yaml with OAuth
mcp_servers:
ryze:
url: "https://connector.get-ryze.ai/mcp"
auth: oauthThis is the flow in the steps above. The entry name ryze is yours to choose, and Hermes Agent prefixes the tools it finds with mcp_ and that name. hermes mcp login ryze runs the authorization and Hermes Agent caches the tokens at ~/.hermes/mcp-tokens/ryze.json, reusing them until a refresh fails. hermes mcp test ryze checks the connection, and hermes mcp configure ryze lets you pick which tools stay on.
A Ryze AI API key instead of OAuth
mcp_servers:
ryze:
url: "https://connector.get-ryze.ai/mcp"
headers:
Authorization: "Bearer ${RYZE_API_KEY}"Leave out auth: oauth and send the key as a bearer header. Put RYZE_API_KEY, the rk_live_ key from Ryze AI, in ~/.hermes/.env instead of writing it into config.yaml; Hermes Agent resolves ${VAR} placeholders when it connects. Then run /reload-mcp. This route needs no browser, which suits a server you reach only over SSH.
Limit the tools with include and exclude
mcp_servers:
ryze:
url: "https://connector.get-ryze.ai/mcp"
auth: oauth
tools:
exclude: ["*updateLocationDetails", "*replyToReview", "*createPost", "*deletePost", "*uploadMedia", "*updateAttributes"]tools.include is a whitelist and tools.exclude a blacklist, and both accept glob patterns. The block above leaves the 8 read tools and drops the 6 write tools. After saving, run /reload-mcp and ask Hermes Agent to list its Ryze AI tools to confirm which ones remain. Whether the patterns match the bare tool name or the mcp_-prefixed name was not tested, so check the list.
Transport and timeouts
Hermes Agent's MCP page says each server entry accepts timeout for tool calls and connect_timeout for the first connection, and gives no default numbers for either. A review list or a long performance range that runs slowly is the case to raise timeout for. Hermes Agent supports stdio servers and HTTP or SSE remote endpoints; the connector is a remote HTTP endpoint, so no local process is involved. HTTP servers honor HTTPS_PROXY, HTTP_PROXY and NO_PROXY.
Hermes Agent and MCP: the facts in one table
| Question | Answer from Hermes Agent's docs |
|---|---|
| Where a server is added | Under mcp_servers in ~/.hermes/config.yaml. hermes mcp opens an interactive picker and hermes mcp install <name> installs a catalog entry |
| Remote server format | url: for the address, then either headers: for a static token or auth: oauth for a browser sign-in |
| Transports | Stdio for local subprocesses, and HTTP or SSE for remote endpoints |
| Sign-in | hermes mcp login <server> authorizes OAuth. Hermes Agent identifies itself with a Client ID Metadata Document where the server supports one and falls back to dynamic client registration where it does not |
| Saved credentials | Tokens are cached at ~/.hermes/mcp-tokens/<server>.json with 0o600 permissions |
| Tool names | Prefixed as mcp_<server_name>_<tool_name>, so the connector's tools begin mcp_ryze_ |
| Tool selection | tools.include and tools.exclude with glob patterns, or hermes mcp configure <name> |
| Plan | None. Open source and self-hosted |
| Reload and test | /reload-mcp reloads from config.yaml and refreshes the tool list. hermes mcp test <name> verifies a connection |
| Other behavior | Sampling and elicitation are on by default. A server can ask Hermes Agent for model output, or for structured input from you through a form |
Sources: Hermes Agent: MCP configuration, Hermes Agent on GitHub (checked November 16, 2026).
Other clients
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 Code
Claude Code registers the same URL with one claude mcp add command. See the Claude Code guide for Google Business Profile.
OpenClaw
OpenClaw, another self-hosted agent, saves the connector as a streamable-http server with its own commands.
ChatGPT and Claude
Both take the URL as a custom connector in their settings, with plan limits that Hermes Agent does not have. The Ryze AI agent in either one can also send a one-time link that connects Google Business Profile; the link works once and for 24 hours.
Permissions and access
Five things decide what Hermes Agent can reach on your listing.
- Google account
- Ryze AI signs in to Google (OAuth) through a connection partner, so Google's screen may show that partner's name. Pick the account that owns or manages the listing.
- Location
- A connection equals one location, and every tool works on the Location saved for it. Confirm your choice before asking for edits.
- Verification
- Full data needs a verified listing. An unverified one returns only part in Ryze AI.
- Who uses the sign-in
- The tokens live in ~/.hermes/mcp-tokens/ on the host, readable only by the account running Hermes Agent. Everyone who can talk to that agent works through the same Ryze AI sign-in and listing.
- Public effect
- Replies, posts, photos and listing edits are visible on Search and Maps. Google reviews new photos and edits before they appear.
What the connection is allowed to do
Two sign-ins stand between Hermes Agent and the listing. Hermes Agent signs in to the Ryze AI connector, and Ryze AI holds a Google sign-in for the profile. The rows show what each part grants and where the fact was found.
| Part | What it grants | Found in |
|---|---|---|
| Hermes Agent to the connector | OAuth with PKCE (S256), using the authorization code and refresh token grants. The connector offers the scopes mcp:read and mcp:write, and Ryze AI supports dynamic client registration only | Connector test, November 13, 2026, and Ryze AI facts |
| The stored token | One file per server under ~/.hermes/mcp-tokens/ with 0o600 permissions, reused until a refresh fails | Hermes Agent MCP docs, November 16, 2026 |
| Workspace and connection | The workspace you approve on the Ryze AI page. A call can carry a connection_id; without one the primary connection is used | Connector calls, November 14, 2026 |
| Ryze AI to Google | A Google OAuth sign-in via a connection partner, whose name can appear on Google's consent screen instead of Ryze AI | Ryze AI facts |
| Profile role | Owner or manager. Google reserves user management and profile removal for owners, so a manager can do everything these 14 tools do | Google Business Profile Help, November 14, 2026 |
| Google API scope | business.manage is the only current Business Profile API scope in the pages read, and none showed a read-only one. The scope Ryze AI asks for was not checked | Google's OAuth guide, November 14, 2026 |
| Listing and plan | The single saved Location, with complete data only if it is verified, on an active Ryze AI plan or trial | Ryze AI facts |
Not covered by the 14 tools: map rank scans, a Ryze AI app feature; questions and answers, because Google shut the My Business Q&A API on November 3, 2025; creating a location, starting verification and adding users; video uploads, since uploadMedia takes photos; alert posts, since createPost handles standard, event and offer while Google's API adds alert; and MESSAGING_CLICKS, a metric Google introduced on October 14, 2026 that was missing from the 11 names getPerformance accepted on November 14, 2026.
Sources: Google OAuth for Business Profile, Google owners and managers, Google API sunset dates (checked November 14, 2026).
Removing access
To cut Hermes Agent off, delete the ryze entry from mcp_servers in ~/.hermes/config.yaml, run /reload-mcp and delete ~/.hermes/mcp-tokens/ryze.json. The Hermes Agent docs describe no logout command, so removing the entry and the token file is the manual route. To disconnect the listing itself, remove Google Business Profile from Integrations in Ryze AI. Google's OAuth guide adds that the profile owner can revoke the access later, from the Google Account permissions page.
What Hermes Agent can do on the listing
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 | Finds Google business categories by name and gives back the category IDs that a listing update accepts. |
| google_business_profile__getLocationDetails | Read | Returns the saved Location as Google holds it: title, opening hours, special hours, description, website, phone, categories, address, open status, place ID, review link, Maps link and verification state. |
| google_business_profile__listReviews | Read | Returns reviews with star rating, comment and whether the owner replied, along with the review count and average rating. Filters cover rating and reply status. |
| google_business_profile__getPerformance | Read | Returns day-by-day Search and Maps counts for impressions, calls, direction requests, website clicks, conversations and bookings, reaching back 18 months. |
| google_business_profile__getSearchKeywords | Read | Returns the queries that surfaced the listing, with a monthly impression count for each. |
| google_business_profile__listPosts | Read | Returns existing posts, newest first, including the ones created directly on Google. |
| google_business_profile__listMedia | Read | Returns the photos and videos attached to the listing. |
| google_business_profile__getAttributes | Read | Returns attribute values such as amenities, services and payment types. |
| google_business_profile__updateLocationDetails | Write | Replaces the listing fields you name, among them hours, special hours, description, website, phone, categories and open status. The change is public on Search and Maps. |
| google_business_profile__replyToReview | Write | Publishes the owner reply under a review. An existing owner reply is replaced. |
| google_business_profile__createPost | Write | Creates a standard, event or offer post, now or on a schedule, with at most one image and an optional call-to-action button. |
| google_business_profile__deletePost | Write | Removes a live post right away. It cannot be undone, and Ryze AI files it under write, not delete. |
| google_business_profile__uploadMedia | Write | Adds one photo from a public URL, filed as cover, logo, exterior, interior, product or a similar category. |
| google_business_profile__updateAttributes | Write | Sets new attribute values on the Google listing. |
Keeping the write tools out of reach
Hermes Agent's MCP page documents no per-call approval prompt for MCP tools, so the control you have is which tools the agent sees. Because the six write tools change a public listing, the standing way to keep them out of reach is tools.exclude on the ryze entry, as in the third block above, or tools.include with only the read tool names. hermes mcp configure ryze does the same interactively. In the Ryze AI chat itself, listing changes follow its Tool approvals setting, which starts on Skip all approvals.
mcp_servers:
ryze:
url: "https://connector.get-ryze.ai/mcp"
auth: oauth
tools:
include: ["*listReviews", "*getPerformance", "*getSearchKeywords", "*getLocationDetails"]Limits in numbers
| Limit | Figure | Set by |
|---|---|---|
| Google API quota | 300 queries per minute per API, covering Business Information, Account Management and Performance, which Google equates to roughly 5 requests per second | |
| Quota before approval | 0 queries per minute until Google approves the project's access request | |
| Rate-limit response | HTTP 429. Google's sample code backs off exponentially with jitter, starting at 1.0 second, for up to 5 retries | |
| Edit rate | 10 edits a minute for each profile, a cap Google says it will not lift | |
| Owner reply size | Up to 4,096 bytes | |
| Keyword freshness | Search terms refresh at the start of each month, and a new month may take up to 5 days to show | |
| Post lifetime | Posts without a date range are archived after 6 months | |
| Category query length | 2 to 80 characters, as the rejected calls of November 14, 2026 showed | Ryze AI connector |
| Performance window | 11 metric names, reaching back 18 months, lagging 2 to 3 days | Ryze AI connector |
| Post and photo size | A post holds 1,500 characters and one image. A photo is JPG or PNG, 10 KB to 5 MB, 250x250 px or larger | Ryze AI connector, and Google's help page for the photo sizes |
| Automatic reload inside a session | A 30 second timeout after a config.yaml edit, too short for an interactive OAuth sign-in | Hermes Agent |
The Google rows bind any app that calls the Business Profile APIs. None of the test answers carried a quota or rate figure, so this guide cannot say which Google quota the Ryze AI connection draws on.
Sources: Business Profile API limits, prerequisites, review reply reference, Google posts help, Google photo help, Google performance help (checked November 14, 2026); Hermes Agent: MCP configuration (checked November 16, 2026).
Business Profile calls through the connector, tested
These are the 11 Business Profile calls sent through the Ryze AI connector on November 14, 2026, from a Claude Code session and not from Hermes Agent. Three were genuine category searches. The other eight were built to fail, with a bad argument or a connection_id that does not exist, so no listing data could come back.
| Call | Tool | Result |
|---|---|---|
| Category search for coffee | searchCategories | Returned 9 categories, including Coffee shop (categories/gcid:coffee_shop) and Coffee roasters |
| Category search for dentist | searchCategories | Returned 6 categories, from Dentist through Prosthetics dentist |
| Category search for zzqqxxvv, which matches nothing | searchCategories | Returned an empty list with no error |
| Category search with a 1-character query | searchCategories | Rejected as invalid_arguments, too_small |
| Category search with a 92-character query | searchCategories | Rejected as invalid_arguments, too_big |
| Attributes read for a connection_id that does not exist | getAttributes | Rejected as not_connected, nothing returned |
| Listing read with a made-up readMask field plus an unknown connection_id | getLocationDetails | Rejected as not_connected. Whether the field name is validated stayed unanswered |
| Reviews with minRating set to 6 | listReviews | Rejected as invalid_arguments, too_big |
| Performance for a metric name that does not exist | getPerformance | Rejected as invalid_arguments, invalid_value, with the 11 accepted names listed in the message |
| Performance starting 2020/01/01 | getPerformance | Rejected as invalid_arguments, invalid_format |
| Search terms starting 2026/08 | getSearchKeywords | Rejected as invalid_arguments, invalid_format |
Four of the refused calls also carried an unknown connection_id, yet each came back as an argument error. The connector checks ranges, formats and options before it looks up the connection. No answer carried a quota, rate-limit or cost figure.
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. Review triage
Which of my Google reviews have 3 stars or fewer and no reply? Show the rating and the comment for each.
Tools used: google_business_profile__listReviews
What comes back: Reviews matching the rating and reply filters, with the review total and average. Ask for draft replies in the same session and read them before telling Hermes Agent to publish any.
2. Discovery numbers
Chart the last 90 days of Search and Maps impressions, calls, direction requests and website clicks by day, then list the searches that showed the business.
Tools used: google_business_profile__getPerformance, google_business_profile__getSearchKeywords
What comes back: Daily counts per metric and a keyword list with monthly impressions. Data lags 2 to 3 days, and Google leaves out keywords under an unpublished impression threshold.
3. Listing audit
Read the listing and point out any empty or contradictory fields among hours, special hours, description, website and categories.
Tools used: google_business_profile__getLocationDetails
What comes back: Current field values, verification status and the Maps link. Nothing is edited until you ask.
To change something, say it in plain words, such as new holiday hours or an offer post. Ryze AI's guide notes that a post can take 24 to 48 hours to show and stays up about 7 days, with a 1,500 character and one image limit. Photos are JPG or PNG, 10 KB to 5 MB, at least 250x250 px. Map rank scans belong to the Ryze AI app and are not a connector tool, so Hermes Agent cannot start one.
10 jobs to hand to Hermes Agent
Ten jobs to give a Hermes Agent session, each matched to the tool behind it. The default connection here means a Google sign-in by an owner or manager with one saved Location. Of these, only the category search was run for this guide.
| Job | What to ask Hermes Agent | Tool | Default connection |
|---|---|---|---|
| Reviews waiting for an answer | Which reviews have no owner reply? Put the lowest ratings first and give me the total and the average. | listReviews | Yes, once the listing is verified |
| Reply to one review | Post this answer under yesterday's review. | replyToReview | Yes. A new reply overwrites the old one |
| Last month in numbers | Break last month into daily impressions, calls, direction requests and website clicks. | getPerformance | Yes, once verified, with a 2 to 3 day lag |
| Queries behind the impressions | Which searches showed the listing over the past quarter, and how many impressions did each get per month? | getSearchKeywords | Yes, once verified |
| A full listing read | Give me hours, special hours, description, categories, phone, website, open status and attributes. | getLocationDetails, getAttributes | Yes |
| Holiday opening hours | Change only the special hours for the holiday and keep the usual hours. | updateLocationDetails | Yes. Google checks edits before they appear |
| Add a category | Look up the Google category for a specialty bakery and add it as a secondary category. | searchCategories, then updateLocationDetails | Yes. Only the search was tested |
| Scheduled offer | Schedule an offer post for Friday with this image and a call-to-action button. | createPost | Yes. 1,500 characters and one image at most |
| Remove an old post | Show the posts and take down the summer sale one. | listPosts, then deletePost | Yes. No undo |
| Swap the cover photo | Show the photos now on the listing, then upload this URL as the cover. | listMedia, then uploadMedia | Yes. JPG or PNG, 10 KB to 5 MB |
The remaining tool, updateAttributes, edits amenities, services or payment types. Google says some attributes apply only in certain locations, countries or categories, so run getAttributes first. Three tasks have no tool: scanning map rankings from 49 spots around the office, which lives in the Ryze AI app; answering listing questions, since Google closed the Q&A API on November 3, 2025; and creating a location, starting verification or adding a manager.
3 ways to connect Hermes Agent to Google Business Profile
Google's own pages list no Business Profile MCP server, so every way into Hermes Agent runs through a third party or through code you write. This guide treats the Ryze AI connector as the main way: the Google side is one sign-in inside Ryze AI, with no Google Cloud project or API application of your own, and the Hermes Agent side is one remote entry in config.yaml. The other ways below were read on their own pages on November 14, 2026 and none was installed in Hermes Agent.
| Way | Runs where | Setup in Hermes Agent | What it reaches on the listing | Price |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Hosted by Ryze AI, one address for every user | A ryze entry under mcp_servers with url and auth: oauth, then hermes mcp login ryze. A Ryze AI API key in an Authorization header can stand in for the sign-in | 14 tools for one Location: details, reviews and replies, posts, photos, attributes, performance and search terms | SEO Starter $129 per month with a 3-day free trial, or Paid Ads $89 per month with a 7-day free trial |
| Composio | Hosted by Composio | Composio's Business Profile toolkit page links a setup page for Hermes. Whether that page covers this toolkit was not checked, and the connection runs through a Google OAuth app you register in Composio's dashboard | A toolkit of 56 tools, among them reviews, review replies, local posts, media, daily metrics, search keyword impressions, location updates and verification | Free up to 10,000 tool calls a month, then $18 per seat a month on Standard |
| Zapier MCP | Hosted by Zapier | Zapier's quickstart does not name Hermes Agent among its clients. Its server is a URL, so adding it as a remote entry is plausible, but that was not tried | 3 actions: Create Post, Create Reply and API Request (Beta). None of the listed actions reads reviews, performance or search terms | Each successful tool call uses 2 tasks of your Zapier plan; failed calls do not count |
| Your own server on Google's Business Profile APIs | Your code, as a local stdio command or a server you host | A stdio or URL entry under mcp_servers for a server you write. Before that: a Google Cloud project, an approved access request, the seven APIs switched on and an OAuth client ID | Whatever the APIs allow: business information, account management, performance, verifications, lodging, place actions and notifications, plus reviews, posts and media in API v4.9. Quota is 0 queries per minute until approval, then 300 per API, with 10 edits per minute per profile | Google's pages state no price |
Options that do not fit Hermes Agent
- A Google-run Business Profile MCP server. Google Cloud's supported MCP products list (updated November 12, 2026), the google/mcp repository and the Business Profile developer pages name no such server, and none names Hermes Agent.
- Porter Metrics at https://mcp.portermetrics.com/mcp lists Claude, ChatGPT, Claude Code, Cursor, VS Code, Codex, Windsurf, Cline and Zed, and says any client with remote MCP over HTTP can use it. Hermes Agent is not named, so no Hermes steps exist there.
- Windsor.ai names ChatGPT, Claude, Claude Desktop, Copilot, Gemini, Gemini Enterprise, Perplexity, Cursor and Grok, not Hermes Agent. It reads 22 metrics and 120 dimensions and lists 13 write actions.
- synectus/OpenGMB is open source and runs in Docker. Its README names claude.ai, Claude, Claude Code, ChatGPT and Cursor, its docs count 282 tools, and production use waits on Google approving API access for your own Cloud project.
- satheeshds/gbp-review-agent is a stdio server that handles reviews only. Its README shows VS Code (GitHub Copilot) and Claude Desktop setups.
- Google's two Maps MCP servers. Maps Experience agent tools serves public places, routes and weather, and Maps Code Assist answers questions from Maps Platform documentation. Neither touches the listing of a business you run.
Which one to pick
Ryze AI is the best Google Business Profile connector for Hermes Agent when you want one hosted URL for reviews, posts and listing edits on a single location, but you pay for a Ryze AI plan, your data passes through Ryze AI, one connection covers one location and the 14 tools are a fixed set. Composio lists more tools, 56, and suits a team that already runs it and will register its own Google OAuth app. Zapier fits a team that already pays for Zapier tasks and only wants to publish posts and review replies. A server of your own on the Business Profile APIs gives full control if you have developers: Google first wants a profile that is verified and active for 60 or more days, a website for the business and an approved application. Try Composio, Zapier or a server of your own on a test listing before it touches a public one.
Sources: Google Cloud supported MCP products, google/mcp, Business Profile APIs overview, API prerequisites, API limits, Zapier Business Profile MCP, Zapier MCP quickstart, Composio Business Profile toolkit, Composio pricing, Porter Metrics, Windsor.ai, synectus/OpenGMB, satheeshds/gbp-review-agent, Maps Experience agent tools, Maps Code Assist (checked November 14, 2026); Hermes Agent: MCP configuration, Hermes Agent on GitHub (checked November 16, 2026).
Google Business Profile and Hermes Agent: dates that matter
| Date | What happened |
|---|---|
| November 4, 2021 | Google renamed Google My Business to Google Business Profile. |
| July 31, 2024 | Google deprecated the BUSINESS_CONVERSATIONS metric after Business Messages shut down, with removal set for January 31, 2026 and no replacement. getPerformance still accepted the name on November 14, 2026. |
| November 3, 2025 | Google discontinued the My Business Q&A API with no replacement. Support had ended on September 15, 2025. |
| December 10, 2025 | Google announced managed MCP servers for its services. Business Profile was neither a launch server nor among the services named as next. |
| October 14, 2026 | Google added the MESSAGING_CLICKS metric to the Performance API. It was not among the 11 names getPerformance accepted on November 14, 2026. |
| November 5, 2026 | Hermes Agent v0.23.0, the Hearth Release, shipped a new plugin API with session-scoped environment values. |
| November 10, 2026 | Hermes Agent v0.23.1 raised the plugin catalog size cap from 2 MiB to 16 MiB. Its GitHub releases page listed canary builds on November 14, 15 and 16, 2026, and the notes read named no change to how remote MCP servers connect. |
| November 12, 2026 | Google Cloud last updated its list of supported MCP products. It has no Business Profile entry. |
Sources: Google's rename post, Performance API change log, API sunset dates, Google Cloud MCP announcement, Google Cloud supported MCP products (checked November 14, 2026); Hermes Agent releases (checked November 16, 2026).
How this guide was tested
Three things stand behind this guide. The connector's address was checked on November 13, 2026, the Business Profile tools were called on November 14, 2026, and the Hermes Agent steps were compared with its documentation on November 16, 2026. Nothing was run inside Hermes Agent.
| What was run | What came back |
|---|---|
| Connector address with no sign-in, November 13, 2026 | HTTP 401 plus a WWW-Authenticate header pointing at the sign-in metadata, which is what an OAuth client needs to begin. |
| The two discovery documents, November 13, 2026 | Both loaded. They list the authorize, token and register endpoints, the authorization code and refresh token grants, PKCE S256 and the scopes mcp:read and mcp:write. |
| Tool list in a signed-in Claude Code session, November 14, 2026 | All 14 Business Profile tools, 8 read and 6 write, matching the tools table. |
| Three category searches, November 14, 2026 | Each succeeded: 9 categories for coffee, 6 for dentist, an empty list for a nonsense word. |
| Eight deliberately bad calls, November 14, 2026 | Every one was rejected before any listing data was read: two length errors, two not_connected replies and four other argument errors, quoted in the errors table. |
| All 11 answers checked for quota or cost figures, November 14, 2026 | None contained a quota, rate-limit or cost figure. |
Not run for this page: every step inside Hermes Agent. It was not installed, no config.yaml entry was saved, hermes mcp login and /reload-mcp were not tried, and the tools.include and tools.exclude patterns were not matched against real tool names. Those steps follow Hermes Agent's documentation as it read on November 16, 2026. The tool calls came from Claude Code, which reaches the same connector and the same 14 tools. No call read a real listing or its reviews, posts, photos, attributes, performance or search terms, and none of the 6 write tools was called, because they change a public listing. Composio and Zapier were read on their own pages and not installed.
Errors and fixes
Exact messages from the connector test
The connector sent back these seven messages on November 14, 2026, copied word for word. Argument errors begin with Invalid arguments for and the tool name, such as google_business_profile.listReviews; the table shows the part after that. If one of them turns up in a Hermes Agent session, this is what it means.
| Message | Meaning | What to do in Hermes Agent |
|---|---|---|
| Integration not connected: google_business_profile | The workspace has no Business Profile connection matching that connection_id. | Repeat the request without a connection_id so the primary connection applies, or connect the profile in Ryze AI, save a Location and open a fresh session. |
| Too small: expected string to have >=2 characters | The category search wants 2 or more characters. | Search with a whole word, such as the trade. |
| Too big: expected string to have <=80 characters | The category search stops at 80 characters. | Use a short phrase, not a sentence. |
| Too big: expected number to be <=5 | Ratings top out at 5 stars. | Keep rating filters between 1 and 5. |
| Invalid option: expected one of "BUSINESS_IMPRESSIONS_DESKTOP_MAPS"|"BUSINESS_IMPRESSIONS_DESKTOP_SEARCH"|"BUSINESS_IMPRESSIONS_MOBILE_MAPS"|"BUSINESS_IMPRESSIONS_MOBILE_SEARCH"|"BUSINESS_CONVERSATIONS"|"BUSINESS_DIRECTION_REQUESTS"|"CALL_CLICKS"|"WEBSITE_CLICKS"|"BUSINESS_BOOKINGS"|"BUSINESS_FOOD_ORDERS"|"BUSINESS_FOOD_MENU_CLICKS" | getPerformance accepts only these 11 metric names. | Describe the figure in everyday words, such as calls, and let Hermes Agent choose the metric, or send no metric to receive all. |
| Expected YYYY-MM-DD | A date needs year, month and day with dashes. | Restate the range, for instance 2026-09-01 to 2026-09-30. |
| Expected YYYY-MM | A month needs year and month with a dash. | Restate the months, for instance 2026-07 to 2026-09. |
Other problems
- The Business Profile tools do not appear in Hermes Agent
- Run hermes mcp test ryze to check the connection, then /reload-mcp or start a new session. If the entry has auth: oauth and no sign-in was done yet, run hermes mcp login ryze first.
- The sign-in dies when I edit config.yaml in a session
- Hermes Agent auto-reloads MCP connections 30 seconds after an edit made inside a running session, which is too short for an interactive OAuth flow. Save the entry, then run hermes mcp login ryze from a terminal.
- The authorize page opens on the wrong machine or nothing opens
- Copy the printed authorize URL into a browser on another machine, approve it, and paste the redirect URL at the prompt Hermes Agent prints in an interactive terminal.
- The tools have long names
- Hermes Agent prefixes each tool as mcp_<server>_<tool>, so a tool of the connector appears with mcp_ryze_ in front. Use that prefix in tools.include and tools.exclude patterns, or start the pattern with *.
- The API key is not read
- Check that RYZE_API_KEY is in ~/.hermes/.env and that the header reads Bearer followed by the placeholder. Run /reload-mcp after any change, and remove auth: oauth from the entry if you use the key route.
- The sign-in worked before and now fails
- Hermes Agent reuses a cached token until a refresh fails. Delete ~/.hermes/mcp-tokens/ryze.json and run hermes mcp login ryze again.
- A corporate proxy blocks the connection
- HTTP servers honor HTTPS_PROXY, HTTP_PROXY and NO_PROXY, so set them in the environment that runs Hermes Agent.
- 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
- The Ryze AI guide says posts can take 24 to 48 hours to appear. Google gives the same window for photos and videos, and 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. One connection is one location.
- The agent 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.
Terms on this page
- mcp_servers
- The block of ~/.hermes/config.yaml where Hermes Agent keeps the MCP servers it connects to, one named entry each.
- auth: oauth
- The setting that tells Hermes Agent an HTTP server uses a browser sign-in, completed with hermes mcp login.
- /reload-mcp
- A Hermes Agent command that reloads MCP servers from config.yaml and refreshes the tool list without ending the session.
- tools.include and tools.exclude
- Settings on a server entry that keep or hide tools by name or glob pattern.
- Verification
- Google's check that you run the business. Performance data and review access through the API need a verified profile.
- Owner and manager
- The two roles on a profile. A manager can do nearly all an owner can, apart from adding or removing users and removing the profile.
- Category ID
- Google's value for a business category, in the form categories/gcid:coffee_shop. The category search returns it and the listing update takes it.
Sources: Hermes Agent: MCP configuration (checked November 16, 2026); Google performance help, Google owners and managers (checked November 14, 2026).
Frequently asked questions
How do I connect Hermes Agent to Google Business Profile?
Connect Google Business Profile in a Ryze AI workspace and save its Location. Then add a ryze entry under mcp_servers in ~/.hermes/config.yaml with url https://connector.get-ryze.ai/mcp and auth: oauth, run hermes mcp login ryze and click Allow connection in the browser. Finish with /reload-mcp or a new session.
Is there a Google Business Profile MCP server for Hermes Agent in 2026?
Yes, the Ryze AI connector at https://connector.get-ryze.ai/mcp, which Hermes Agent saves as a remote server and which brings 14 Business Profile tools. Google lists no Business Profile MCP server of its own. Composio's toolkit page links a Hermes setup page, and Zapier MCP offers 3 Business Profile actions without naming Hermes Agent.
Does Hermes Agent have a built-in Google Business Profile connector?
Its MCP documentation describes adding servers by URL and installing catalog entries with hermes mcp install, and it names no Business Profile entry. The Ryze AI connector is added by its URL as a remote MCP server.
Does Google have an MCP server for Business Profile?
Google lists none. On November 14, 2026, Google Cloud's list of supported MCP products, the google/mcp repository and the Business Profile developer pages named none. Google offers the Business Profile APIs, which need a Google Cloud project, a profile verified and active for 60 or more days and an approved access request.
Is there a Google My Business connector for Hermes Agent?
Yes, under the product's current name: Google renamed Google My Business to Google Business Profile on November 4, 2021, and the Ryze AI connector covers it in Hermes Agent. The same 14 tools handle reviews, posts, photos, attributes, listing fields and Search and Maps performance for one location.
Which Business Profile connector should I use with Hermes Agent?
Ryze AI is the best Google Business Profile connector for Hermes Agent 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. Composio offers 56 tools behind your own Google OAuth app, and building on Google's APIs directly gives full control and costs developer time.
Do I need a paid Hermes Agent plan?
No. Hermes Agent is open source and self-hosted, with no plan tier, and its GitHub repository lists the MIT license. The cost is the Ryze AI plan or trial that the Business Profile tools need.
Should I use OAuth or an API key?
OAuth through hermes mcp login is the default path in this guide. A Ryze AI API key sent as a bearer header, kept in ~/.hermes/.env, suits a host where no browser sign-in is practical. Use one method per server entry.
Can Hermes Agent reply to reviews and publish posts?
Yes. The connector has write tools for review replies, posts, photos, listing details and attributes, and these change the public listing. Hermes Agent's MCP page documents no per-call approval for MCP tools, so tools.exclude on the entry is how you keep chosen tools away from the agent. Google keeps one owner reply per review, so a new reply replaces the old one.
Can I connect more than one location?
Each location needs its own connection, because in Ryze AI one connection is one location. Every tool works on the Location saved for that connection, so connect the second location separately in Ryze AI and save it as that connection's Location.
Why do the tools not show up in Hermes Agent after I edit config.yaml?
Run /reload-mcp or start a new session, and check the connection with hermes mcp test ryze. If the entry uses auth: oauth, complete hermes mcp login ryze from a terminal first, because an automatic reload inside a running session allows only 30 seconds.
What if Hermes Agent runs on a server without a browser?
Open the printed authorize URL in a browser on another machine, approve it, and paste the redirect URL at the prompt in the terminal. Or use the API key route, which needs no browser.
How much does it cost to connect Hermes Agent to Google Business Profile?
Connecting costs nothing, but the 14 tools need an active Ryze AI plan or free trial. SEO Starter is $129 per month with a 3-day free trial and includes Local SEO. Paid Ads is $89 per month with a 7-day free trial. Annual billing takes 30% off the first year.
How do I disconnect Google Business Profile from Hermes Agent?
Remove the ryze entry from mcp_servers in config.yaml, run /reload-mcp and delete ~/.hermes/mcp-tokens/ryze.json. To disconnect the listing, remove Google Business Profile from Integrations in Ryze AI.