How to connect Hermes Agent to Google Business Profile

Connect your listing in Ryze AI, add one MCP URL to ~/.hermes/config.yaml, sign in with hermes mcp login, then hand reviews, posts and listing details to Hermes Agent.

Your MCP URL
https://connector.get-ryze.ai/mcp

Copies the connector URL for the config.yaml entry. See the steps

See pricing

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.

  1. In Ryze AI open Integrations, click Connect on Google Business Profile and sign in with the Google account that manages the listing
  2. Pick the Location this workspace works on and click Save
  3. Add a ryze entry with the connector URL and auth: oauth under mcp_servers in ~/.hermes/config.yaml
  4. 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

FactDetail
Main way to connectThe Ryze AI connector, saved in Hermes Agent as a remote MCP server named ryze
Server addresshttps://connector.get-ryze.ai/mcp, set as url: under mcp_servers in ~/.hermes/config.yaml
Sign-inOAuth with auth: oauth, completed by hermes mcp login ryze. A Ryze AI API key in an Authorization header is the other route
Business Profile tools14 in all: 8 that read and 6 that write. Removing a post counts as a write
Can it change the listingYes. 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 usesThe one you complete with hermes mcp login, cached on the machine that runs Hermes Agent
LocationsOne connection is one location, and every tool works on the Location saved for it
Hermes Agent planNone to buy. Hermes Agent is open source and self-hosted, and its GitHub repository lists the MIT license
Ryze AI priceSEO 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 AgentGoogle 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 testedThe 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.

  1. 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.

  2. 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.

  3. 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: oauth
  4. Sign 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.

  5. 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.

  6. 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: oauth

This 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

QuestionAnswer from Hermes Agent's docs
Where a server is addedUnder mcp_servers in ~/.hermes/config.yaml. hermes mcp opens an interactive picker and hermes mcp install <name> installs a catalog entry
Remote server formaturl: for the address, then either headers: for a static token or auth: oauth for a browser sign-in
TransportsStdio for local subprocesses, and HTTP or SSE for remote endpoints
Sign-inhermes 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 credentialsTokens are cached at ~/.hermes/mcp-tokens/<server>.json with 0o600 permissions
Tool namesPrefixed as mcp_<server_name>_<tool_name>, so the connector's tools begin mcp_ryze_
Tool selectiontools.include and tools.exclude with glob patterns, or hermes mcp configure <name>
PlanNone. 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 behaviorSampling 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.

How to connect Claude Code to Google Business Profile

OpenClaw

OpenClaw, another self-hosted agent, saves the connector as a streamable-http server with its own commands.

How to connect OpenClaw to Google Business Profile

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.

How to connect ChatGPT to Google Business Profile

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.

PartWhat it grantsFound in
Hermes Agent to the connectorOAuth 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 onlyConnector test, November 13, 2026, and Ryze AI facts
The stored tokenOne file per server under ~/.hermes/mcp-tokens/ with 0o600 permissions, reused until a refresh failsHermes Agent MCP docs, November 16, 2026
Workspace and connectionThe workspace you approve on the Ryze AI page. A call can carry a connection_id; without one the primary connection is usedConnector calls, November 14, 2026
Ryze AI to GoogleA Google OAuth sign-in via a connection partner, whose name can appear on Google's consent screen instead of Ryze AIRyze AI facts
Profile roleOwner or manager. Google reserves user management and profile removal for owners, so a manager can do everything these 14 tools doGoogle Business Profile Help, November 14, 2026
Google API scopebusiness.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 checkedGoogle's OAuth guide, November 14, 2026
Listing and planThe single saved Location, with complete data only if it is verified, on an active Ryze AI plan or trialRyze 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.

ToolTypeWhat it does
google_business_profile__searchCategoriesReadFinds Google business categories by name and gives back the category IDs that a listing update accepts.
google_business_profile__getLocationDetailsReadReturns 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__listReviewsReadReturns 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__getPerformanceReadReturns day-by-day Search and Maps counts for impressions, calls, direction requests, website clicks, conversations and bookings, reaching back 18 months.
google_business_profile__getSearchKeywordsReadReturns the queries that surfaced the listing, with a monthly impression count for each.
google_business_profile__listPostsReadReturns existing posts, newest first, including the ones created directly on Google.
google_business_profile__listMediaReadReturns the photos and videos attached to the listing.
google_business_profile__getAttributesReadReturns attribute values such as amenities, services and payment types.
google_business_profile__updateLocationDetailsWriteReplaces 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__replyToReviewWritePublishes the owner reply under a review. An existing owner reply is replaced.
google_business_profile__createPostWriteCreates 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__deletePostWriteRemoves a live post right away. It cannot be undone, and Ryze AI files it under write, not delete.
google_business_profile__uploadMediaWriteAdds one photo from a public URL, filed as cover, logo, exterior, interior, product or a similar category.
google_business_profile__updateAttributesWriteSets 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

LimitFigureSet by
Google API quota300 queries per minute per API, covering Business Information, Account Management and Performance, which Google equates to roughly 5 requests per secondGoogle
Quota before approval0 queries per minute until Google approves the project's access requestGoogle
Rate-limit responseHTTP 429. Google's sample code backs off exponentially with jitter, starting at 1.0 second, for up to 5 retriesGoogle
Edit rate10 edits a minute for each profile, a cap Google says it will not liftGoogle
Owner reply sizeUp to 4,096 bytesGoogle
Keyword freshnessSearch terms refresh at the start of each month, and a new month may take up to 5 days to showGoogle
Post lifetimePosts without a date range are archived after 6 monthsGoogle
Category query length2 to 80 characters, as the rejected calls of November 14, 2026 showedRyze AI connector
Performance window11 metric names, reaching back 18 months, lagging 2 to 3 daysRyze AI connector
Post and photo sizeA post holds 1,500 characters and one image. A photo is JPG or PNG, 10 KB to 5 MB, 250x250 px or largerRyze AI connector, and Google's help page for the photo sizes
Automatic reload inside a sessionA 30 second timeout after a config.yaml edit, too short for an interactive OAuth sign-inHermes 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.

CallToolResult
Category search for coffeesearchCategoriesReturned 9 categories, including Coffee shop (categories/gcid:coffee_shop) and Coffee roasters
Category search for dentistsearchCategoriesReturned 6 categories, from Dentist through Prosthetics dentist
Category search for zzqqxxvv, which matches nothingsearchCategoriesReturned an empty list with no error
Category search with a 1-character querysearchCategoriesRejected as invalid_arguments, too_small
Category search with a 92-character querysearchCategoriesRejected as invalid_arguments, too_big
Attributes read for a connection_id that does not existgetAttributesRejected as not_connected, nothing returned
Listing read with a made-up readMask field plus an unknown connection_idgetLocationDetailsRejected as not_connected. Whether the field name is validated stayed unanswered
Reviews with minRating set to 6listReviewsRejected as invalid_arguments, too_big
Performance for a metric name that does not existgetPerformanceRejected as invalid_arguments, invalid_value, with the 11 accepted names listed in the message
Performance starting 2020/01/01getPerformanceRejected as invalid_arguments, invalid_format
Search terms starting 2026/08getSearchKeywordsRejected 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.

JobWhat to ask Hermes AgentToolDefault connection
Reviews waiting for an answerWhich reviews have no owner reply? Put the lowest ratings first and give me the total and the average.listReviewsYes, once the listing is verified
Reply to one reviewPost this answer under yesterday's review.replyToReviewYes. A new reply overwrites the old one
Last month in numbersBreak last month into daily impressions, calls, direction requests and website clicks.getPerformanceYes, once verified, with a 2 to 3 day lag
Queries behind the impressionsWhich searches showed the listing over the past quarter, and how many impressions did each get per month?getSearchKeywordsYes, once verified
A full listing readGive me hours, special hours, description, categories, phone, website, open status and attributes.getLocationDetails, getAttributesYes
Holiday opening hoursChange only the special hours for the holiday and keep the usual hours.updateLocationDetailsYes. Google checks edits before they appear
Add a categoryLook up the Google category for a specialty bakery and add it as a secondary category.searchCategories, then updateLocationDetailsYes. Only the search was tested
Scheduled offerSchedule an offer post for Friday with this image and a call-to-action button.createPostYes. 1,500 characters and one image at most
Remove an old postShow the posts and take down the summer sale one.listPosts, then deletePostYes. No undo
Swap the cover photoShow the photos now on the listing, then upload this URL as the cover.listMedia, then uploadMediaYes. 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.

WayRuns whereSetup in Hermes AgentWhat it reaches on the listingPrice
Ryze AI connector (the main way)Hosted by Ryze AI, one address for every userA 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-in14 tools for one Location: details, reviews and replies, posts, photos, attributes, performance and search termsSEO Starter $129 per month with a 3-day free trial, or Paid Ads $89 per month with a 7-day free trial
ComposioHosted by ComposioComposio'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 dashboardA toolkit of 56 tools, among them reviews, review replies, local posts, media, daily metrics, search keyword impressions, location updates and verificationFree up to 10,000 tool calls a month, then $18 per seat a month on Standard
Zapier MCPHosted by ZapierZapier'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 tried3 actions: Create Post, Create Reply and API Request (Beta). None of the listed actions reads reviews, performance or search termsEach successful tool call uses 2 tasks of your Zapier plan; failed calls do not count
Your own server on Google's Business Profile APIsYour code, as a local stdio command or a server you hostA 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 IDWhatever 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 profileGoogle'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

DateWhat happened
November 4, 2021Google renamed Google My Business to Google Business Profile.
July 31, 2024Google 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, 2025Google discontinued the My Business Q&A API with no replacement. Support had ended on September 15, 2025.
December 10, 2025Google announced managed MCP servers for its services. Business Profile was neither a launch server nor among the services named as next.
October 14, 2026Google added the MESSAGING_CLICKS metric to the Performance API. It was not among the 11 names getPerformance accepted on November 14, 2026.
November 5, 2026Hermes Agent v0.23.0, the Hearth Release, shipped a new plugin API with session-scoped environment values.
November 10, 2026Hermes 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, 2026Google 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 runWhat came back
Connector address with no sign-in, November 13, 2026HTTP 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, 2026Both 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, 2026All 14 Business Profile tools, 8 read and 6 write, matching the tools table.
Three category searches, November 14, 2026Each succeeded: 9 categories for coffee, 6 for dentist, an empty list for a nonsense word.
Eight deliberately bad calls, November 14, 2026Every 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, 2026None 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.

MessageMeaningWhat to do in Hermes Agent
Integration not connected: google_business_profileThe 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 charactersThe category search wants 2 or more characters.Search with a whole word, such as the trade.
Too big: expected string to have <=80 charactersThe category search stops at 80 characters.Use a short phrase, not a sentence.
Too big: expected number to be <=5Ratings 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-DDA date needs year, month and day with dashes.Restate the range, for instance 2026-09-01 to 2026-09-30.
Expected YYYY-MMA 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.

Connect your Google Business Profile listing to Hermes Agent

Local SEO is part of SEO Starter at $129 per month with a 3-day free trial. The 14 Business Profile tools also work on Paid Ads at $89 per month with a 7-day free trial. Annual billing takes 30% off the first year.

Business Profile with AI

Need help? Read the Ryze AI Google Business Profile guide or email Ryze AI support.