By Ira Bodnar, Ryze AI · Updated
Quick answer
To connect Gemini to HubSpot, connect HubSpot in a Ryze AI workspace with HubSpot's own sign-in, then add https://connector.get-ryze.ai/mcp as a custom app in the Gemini web app under Settings, Connected Apps, and type @ to pick it in a prompt. The Gemini web app needs a US-based, adult, personal Google Account.
- In Ryze AI open Integrations, find HubSpot and click Connect
- Sign in to HubSpot, choose the account and approve the permissions
- In Gemini open Settings, Connected Apps, Add a custom app and paste the URL
- Sign in on the Ryze AI page, click Allow connection, then type @ and pick Ryze AI
Before you start
- A Gemini account that can add custom apps. Google's help page says custom apps need you to be 18 or over and in the US, signed in with a personal Google Account (not a work or school account), with Keep Activity on. Custom apps are English only, can only be added in the Gemini web app and then also work in the Gemini mobile app. The page names no paid plan.
- Super Admin or App Marketplace Access in HubSpot. HubSpot only lets users with one of these permissions install apps. Anyone else has to ask a Super Admin to connect. If the portal's plan lacks a scope the app requires, HubSpot shows an error during install.
- A Ryze AI workspace on a plan or free trial. Paid Ads is $89 per month with a 7-day free trial. Connecting the connector is free, but the HubSpot tools need an active plan or trial. Gemini Enterprise is not covered here: it needs an administrator and a pre-registered OAuth client, and Ryze AI does not offer one.
How to connect Gemini to HubSpot in the Gemini web app
Three steps happen in Ryze AI and HubSpot, three in Gemini. The connector URL is the same for every user.
Connect HubSpot in Ryze AI
Create a Ryze AI account or sign in, open Integrations, find the HubSpot card and click Connect. Ryze AI sends you to HubSpot to authorize.
Sign in to HubSpot and choose the account
Sign in to the HubSpot account you want Gemini to work with. If your login has access to more than one HubSpot account (portal), pick the one you want and click Choose Account.
Approve the permissions
HubSpot lists the access Ryze AI requests. Review it and approve. HubSpot sends you back to Ryze AI and the HubSpot card shows the connection.
Add the custom app in Gemini
On a computer, go to gemini.google.com. At the bottom click Settings, then Connected Apps (if Connected Apps is missing, click Personal Intelligence, then Connected Apps). Under Custom apps use the Add a custom app link, or click Add a custom app if one is already connected. Enter https://connector.get-ryze.ai/mcp and click Next. Ryze AI supports dynamic client registration, so you do not enter credentials under Advanced features.
Sign in and allow the workspace
Follow the on-screen instructions: sign in on the Ryze AI page, choose the workspace that holds your HubSpot connection and click Allow connection.
Pick Ryze AI in a prompt and ask your first question
In a Gemini prompt type @ and select the Ryze AI app. Ask: List the 10 most recently created HubSpot deals with name, amount and stage. Once connected on the web, the app also works in the Gemini mobile app.
The Ryze AI help article for HubSpot covers the HubSpot side of the connection, and the HubSpot MCP server docs cover HubSpot's own server.
Gemini CLI
Gemini CLI adds HTTP MCP servers from the command line. Google moved Gemini CLI access in 2026: since June 18, 2026 it no longer serves Google AI Pro and Ultra users or people using it free through Gemini Code Assist for individuals, and Google points them to Antigravity CLI. It remains available with Gemini Code Assist Standard or Enterprise licenses and with paid API keys. If you can use it, one command registers the connector:
gemini mcp add --transport http -s user ryze https://connector.get-ryze.ai/mcpThe default scope is project, so -s user makes the server available in all your projects. Start Gemini CLI: on a 401 it discovers OAuth, registers a client and opens a browser for the Ryze AI sign-in. /mcp auth ryze starts or repeats the sign-in.
Or add the server to settings.json:
{
"mcpServers": {
"ryze": {
"httpUrl": "https://connector.get-ryze.ai/mcp"
}
}
}OAuth needs a local browser and a localhost callback, so it does not work in headless environments or SSH sessions without X11 forwarding. For those, Ryze AI offers API keys (Workspace Settings, Profile, API keys) sent as a Bearer token with the --header flag. By default Gemini CLI confirms tool calls; trust: true (or --trust) bypasses every confirmation, so leave it off for a CRM. --include-tools and --exclude-tools (includeTools and excludeTools in settings.json) filter which tools load.
Other AI clients
The same URL works in other clients. HubSpot is connected once in Ryze AI, so nothing changes on the HubSpot side.
Claude
Claude uses Customize, Connectors, Add custom connector with the same URL. The steps are in the Claude guide linked under Related guides below.
ChatGPT
OpenAI's help center says custom MCP servers are available on ChatGPT Business and Enterprise/Edu, and Pro users can connect custom servers with read and fetch permissions only. Add Ryze AI as a custom MCP server with OAuth and the same URL.
Cursor
Add the server to .cursor/mcp.json. Cursor runs OAuth with dynamic client registration, so you sign in on the Ryze AI page and click Allow connection.
{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }HubSpot permissions and scopes
The HubSpot side of the connection is a standard HubSpot OAuth sign-in through Ryze AI. Three things decide what Gemini can see.
- Who can connect
- A HubSpot Super Admin or a user with App Marketplace Access; anyone else needs a Super Admin to do the install. If the portal's plan lacks a scope the app requires, HubSpot shows an error during install.
- Which account
- One connection is one HubSpot account (portal). If your login sees several, HubSpot asks you to choose one. You can add more portals to the same Ryze AI workspace later with Add one more account; the starred one is used unless you name another.
- Which Gemini account
- The Ryze AI sign-in happens in the Gemini account you add the custom app to. The Gemini app only accepts personal Google Accounts, so a shared team workflow in the web app means each person adds the app themselves.
Scopes behind each action
Ryze AI's source lists the access it requests from HubSpot. The consent screen itself is the source of truth for the exact list.
| Action in Ryze AI | HubSpot access requested |
|---|---|
| Read and edit contacts, companies and deals | Contacts, companies and deals: read and write |
| Look up record owners | Owners: read |
| Know which properties exist | Contact schema: read. Deal schema: read and write |
| Read contact lists | Lists: read |
| Read and edit CMS blog content | Content |
| Optional extras | Files, CMS functions, knowledge base and membership are listed as optional |
Source: the Ryze AI help center HubSpot article. The HubSpot consent screen lists the exact permissions.
Removing access
To remove access, uninstall the app in HubSpot under Settings, Integrations, Connected Apps. In Ryze AI, click View on the HubSpot card and use the trash icon to disconnect a portal. In Gemini, open Settings, Connected Apps and remove the Ryze AI custom app.
What Gemini can do in HubSpot
The Ryze AI connector exposes five HubSpot tools. Each runs as the HubSpot account you connected.
| Tool | Type | What it does |
|---|---|---|
| hubspot__read | Read | Sends a GET request to any HubSpot JSON API resource, such as a record, property definitions, owners, a list or blog posts. |
| hubspot__search | Read | Searches CRM records through the HubSpot CRM Search API with filter groups, sorts, a text query and chosen properties. |
| hubspot__listObjects | Read | Lists CRM records of one object type page by page, with the properties you choose and the IDs of associated records. |
| hubspot__write | Write | Creates or updates a HubSpot resource, such as a contact, company, deal or blog post, and adds associations between records. |
| hubspot__delete | Delete | Deletes (archives) a HubSpot resource by ID, such as a CRM record or blog post. |
Google's help page says Gemini requires manual confirmation for any write actions in the app, and notes that mistakes can still happen. In Gemini CLI, tool calls are confirmed by default unless you set trust. In the Ryze AI chat, the Tool approvals setting starts on Skip all approvals; switch it to Approve write & delete or Manual approve if you use that chat. Scheduled tasks run without an approval step.
First 3 prompts to run
Each answer comes from your own HubSpot account. These prompts describe what the tools can return and show no sample numbers.
1. Review recent deals
Search HubSpot deals created in the last 30 days and list deal name, amount, stage and owner. Group them by stage.
Tools used: hubspot__search, hubspot__read for owners
What comes back: A table of deals grouped by stage, with the owner on each row. HubSpot returns a default set of properties unless you name specific ones.
2. Find contacts missing data
List HubSpot contacts and show email, company and lifecycle stage. Point out the contacts that have no company associated.
Tools used: hubspot__listObjects with associations
What comes back: A page of contacts with the properties you named and the IDs of associated companies, so Gemini can flag the ones with none. Ask for the next page to continue.
3. Update one record with confirmation
Find the HubSpot deal named Q4 renewal and change its stage to the next stage in the pipeline. Show me what you will change before you do it.
Tools used: hubspot__search, hubspot__read for property definitions, hubspot__write
What comes back: The matching deal, the pipeline stages it can move to, and a write request. In the Gemini app you confirm the write manually.
Replace Q4 renewal with a real deal name. Delete requests also go through Gemini's confirmation, and most CRM deletes go to HubSpot's recycling bin.
Ryze AI vs HubSpot's own MCP server
HubSpot's developer docs name Gemini among the clients its remote MCP server works with. The two options suit different setups.
| Option | Setup | HubSpot coverage | Other platforms |
|---|---|---|---|
| Ryze AI connector | HubSpot sign-in inside Ryze AI, then one custom app URL in Gemini. No client ID or secret to enter | Contacts, companies and deals (read and edit), contact lists, owners, CMS blog content. Delete when asked | The other platforms connected in the same Ryze AI workspace, on the same URL |
| HubSpot remote MCP server | Create an MCP connector in HubSpot under Development, MCP Connectors, then give your client the URL https://mcp.hubspot.com. OAuth 2.1 with PKCE is required | Read and write on CRM records, activities, marketing content, campaigns, conversations and social media; SQL-style querying; scopes follow your HubSpot user permissions | HubSpot only |
HubSpot's server limits searches to 200 results per page and 100 object IDs per request. If the work stays inside HubSpot and you are comfortable creating a HubSpot MCP connector, the official server covers more HubSpot areas. The Ryze AI connector skips the HubSpot developer step and shares the URL with the other Ryze AI platforms. HubSpot's docs name Gemini as supported but this page did not test the HubSpot server inside the Gemini app, and Ryze AI was also not tested in Gemini during this research.
Sources: HubSpot remote MCP server, Gemini custom apps help, Gemini CLI MCP servers, Gemini CLI transition to Antigravity CLI, Ryze AI HubSpot integration. Checked November 9, 2026.
HubSpot errors and fixes
- Connected Apps or Add a custom app is missing in Gemini
- Custom apps need a personal Google Account, age 18 or over, the US and Keep Activity on, and they can only be added on the Gemini web app at gemini.google.com. If Connected Apps is missing, try Personal Intelligence, then Connected Apps.
- Gemini asks for a client ID or secret
- Ryze AI supports dynamic client registration, so leave the credentials under Advanced features empty. Only the HubSpot developer server needs a client ID and secret.
- HubSpot shows an error during the install
- Your HubSpot user is not a Super Admin or lacks App Marketplace Access, or the portal's plan lacks a scope the app requires. Ask a Super Admin to connect HubSpot in Ryze AI.
- The wrong HubSpot account is connected
- Each connection is one portal. Click View on the HubSpot card in Ryze AI, connect the right portal with Add one more account, then remove the wrong one with the trash icon.
- A field is missing from the results
- HubSpot returns a default subset of properties unless specific fields are requested. Ask Gemini for the exact properties you need.
- Gemini CLI OAuth fails over SSH
- OAuth needs a local browser and a localhost callback. Use a Ryze AI API key with the --header flag, or sign in on a machine with a browser.
- HubSpot tools do not appear after connecting
- If the connector was added before HubSpot was connected in Ryze AI, remove the custom app, add it again and start a new chat so the tool list refreshes.
- Gemini CLI says you no longer have access
- Since June 18, 2026 Gemini CLI does not serve Google AI Pro and Ultra users or free Gemini Code Assist for individuals users. Google points them to Antigravity CLI.
- The tools reply that a subscription is required
- The HubSpot tools need an active Ryze AI plan or free trial. Start the trial, then retry.
Frequently asked questions
How do I connect Gemini to HubSpot?
Connect HubSpot in a Ryze AI workspace: open Integrations, click Connect on HubSpot, sign in, choose the account and approve the permissions. Then on gemini.google.com open Settings, Connected Apps, Add a custom app, enter https://connector.get-ryze.ai/mcp, click Next, sign in on the Ryze AI page and click Allow connection. Type @ and select Ryze AI in a prompt.
Does HubSpot have a Gemini connector?
HubSpot's developer docs describe a remote MCP server at mcp.hubspot.com and name Gemini among the supported clients. You create an MCP connector in HubSpot under Development, MCP Connectors and use OAuth 2.1 with PKCE. HubSpot's separate connector for Claude page mentions only Claude.
Which HubSpot connector should I use with Gemini?
Ryze AI is the best way to connect Gemini to HubSpot without creating a HubSpot developer connector, but HubSpot's own MCP server covers more HubSpot areas such as campaigns, conversations and social. Pick HubSpot's server if you only need HubSpot and can set up its OAuth client, and Ryze AI if you want one URL and no client ID.
Which Gemini plan do I need?
Google's help page for custom apps names no plan. It requires being 18 or over and in the US, a personal Google Account (not work or school) and Keep Activity on. Custom apps are English only and can only be added in the Gemini web app.
What HubSpot permissions do I need?
You need to be a Super Admin or have App Marketplace Access in HubSpot; otherwise a Super Admin has to connect it. The portal must also include every scope the app requires, or HubSpot shows an error during install.
Can Gemini edit or delete HubSpot records?
Yes, through the Ryze AI write and delete tools, which can create or update contacts, companies, deals and blog posts and delete records when asked. Google says Gemini requires manual confirmation for any write actions. Most CRM deletes go to HubSpot's recycling bin; deleted blog posts may not be recoverable.
Can I use Gemini CLI with HubSpot?
Yes, if you have access. Run gemini mcp add --transport http -s user ryze https://connector.get-ryze.ai/mcp, start Gemini CLI and sign in. Since June 18, 2026 Gemini CLI no longer serves Google AI Pro and Ultra users or free Gemini Code Assist for individuals users; Google points them to Antigravity CLI.
Does this work with Gemini Enterprise?
This guide does not cover it. Google's Gemini Enterprise custom MCP setup is done by an administrator in the Google Cloud console and needs a pre-registered OAuth client ID and secret, which Ryze AI does not provide.
Can I connect more than one HubSpot account?
Yes. Click View on the HubSpot card in Ryze AI and choose Add one more account. The starred account is the primary that is used by default; name another account in chat to switch.
Why do the HubSpot tools not show up in Gemini?
If you connected HubSpot in Ryze AI after adding the custom app, remove the app in Settings, Connected Apps, add it again and start a new chat. Also check that Keep Activity is on, because the custom apps feature is unavailable without it.
How much does it cost to connect Gemini to HubSpot?
Adding the connector costs nothing, but the HubSpot tools need an active Ryze AI plan or 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 HubSpot from Gemini?
Remove the Ryze AI custom app in Gemini under Settings, Connected Apps. To cut HubSpot off at the source, disconnect the portal in Ryze AI with the trash icon on the HubSpot card, or uninstall the app in HubSpot under Settings, Integrations, Connected Apps.