By Ira Bodnar, Ryze AI · Updated
Quick answer
To connect Grok to HubSpot, connect HubSpot in a Ryze AI workspace through the HubSpot sign-in, then go to grok.com/connectors, click New Connector, choose Custom, enter https://connector.get-ryze.ai/mcp and finish the Ryze AI sign-in. Grok then has 5 HubSpot tools for the account you connected.
- In Ryze AI open Integrations, find the HubSpot card and click Connect
- Sign in to HubSpot, choose the account (portal) and approve the permissions
- On grok.com/connectors click New Connector, then Custom, and enter the URL
- Sign in on the Ryze AI page, choose workspaces, click Allow connection and start a chat
Before you start
- A Grok account. xAI says connectors on grok.com, including custom MCP connectors, are available to all Grok users. On Grok Business and Enterprise a team admin must first add the connector in the console. Grok Bot is a separate surface: it is included in The X Subscription Premium, Super and Ultra plans, and the Plus plan does not include it.
- A HubSpot login that can approve the connection. Ryze AI connects through HubSpot OAuth: you sign in, choose the account (portal) and approve the permissions HubSpot lists. If HubSpot refuses the install for your login, ask a HubSpot admin for your account to approve it.
- A Ryze AI workspace on a plan or free trial. Paid Ads is $89 per month with a 7-day free trial. Agency ($279 per month) and SEO Starter ($129 per month, 3-day free trial, for blog publishing) also work. Connecting is free. The HubSpot tools need an active plan or trial.
How to connect Grok to HubSpot on grok.com
HubSpot is connected once in Ryze AI, then Grok adds the connector. The connector URL is the same for every user.
Connect HubSpot in Ryze AI
In the Ryze AI app open Integrations, find the HubSpot card and click Connect. Ryze AI sends you to HubSpot to sign in.
Choose the account and approve the permissions
Sign in to HubSpot, choose the account (portal) and click Choose Account. Approve the requested permissions. HubSpot returns you to Ryze AI with the connection saved.
Add a custom connector in Grok
Go to grok.com/connectors and click New Connector, then select Custom. Enter the MCP server URL https://connector.get-ryze.ai/mcp. xAI requires the MCP server to be reachable over the public internet, and this URL is.
Sign in on the Ryze AI page and allow the workspace
Complete the authentication Grok asks for: sign in on the Ryze AI page, choose the workspace that holds your HubSpot connection and click Allow connection.
Start a chat and ask about HubSpot
Grok discovers the Ryze AI tools and makes them available in conversations. Ask: Find the HubSpot deals I own and list each with its name, amount and stage.
xAI describes the grok.com authentication step only as completing any required authentication, and it does not name OAuth. The Ryze AI sign-in and Allow connection page is what the Ryze AI help center describes for Grok. Ryze AI on grok.com was not tested for this page. If the HubSpot tools are missing because you connected HubSpot after adding the connector, remove the connector in Grok, add it again and start a new chat. The Ryze AI help center Grok page covers the client side.
Grok Business, Grok Bot and Grok Build
grok.com is the simplest route. The other surfaces take the same URL and the same Ryze AI sign-in. HubSpot stays connected in Ryze AI, so the HubSpot sign-in does not repeat.
Grok Business and Enterprise (admin)
On a team plan the admin adds the connector in the console first. Adding connectors needs Team Read-Write permissions.
- Log in to console.x.ai, select the team and go to Grok Business, then Connectors.
- Click + Add Connector, select Other and enter https://connector.get-ryze.ai/mcp.
- Complete any required authentication.
- Team members then connect their own accounts on grok.com/connectors.
Grok Bot
The Ryze AI help center lists Ryze AI as a built-in app in the Grok Bot Connect apps catalog. xAI's public docs do not list it, and this was not verified. If you cannot find it, ask the Bot to add the URL above as a custom MCP server. Anyone who added Ryze AI as a custom server earlier should uninstall that copy to avoid duplicate tools.
- Open Connect apps from the Grok Bot sidebar. On the mobile app, tap your avatar at the top left, then Connect apps.
- Type Ryze AI in Search across apps and skills, open Ryze AI (developer: Ryze AI) and click Add.
- Your browser opens Ryze AI: sign in, choose workspaces and click Allow connection.
- When Authorization complete appears, click Open Grok Bot or Return to Grok Bot.
- Start a new chat and type @ to attach the app to a task.
App connections are account-wide and available to every Bot you run. A team connector policy can show an app as Disabled by team admin. xAI includes Grok Bot in The X Subscription Premium, Super and Ultra plans and not in Plus.
Grok Build CLI
Grok Build adds remote HTTP servers from a terminal.
- Run the command below.
- The browser sign-in starts on first use. Complete the Ryze AI sign-in.
- In the terminal interface, /mcps opens the MCP tab, where i authenticates an OAuth server.
grok mcp add --transport http ryze https://connector.get-ryze.ai/mcpGrok Build keeps OAuth tokens in ~/.grok/mcp_credentials.json and names tools <server>__<tool>, so a HubSpot tool appears as ryze__ followed by its name.
Sources: xAI's Grok connectors, connector management, Grok Bot apps, Grok Bot plans and Grok Build MCP servers, and the Ryze AI help center Grok page.
What Grok can reach in HubSpot
Grok never receives your HubSpot login. HubSpot sign-in happens in Ryze AI, and three settings decide what Grok can reach.
- The HubSpot permissions you approve
- Ryze AI asks HubSpot for the scopes listed in the table below. HubSpot shows them on its consent screen, and that screen is the source of truth for what you grant.
- Which account
- Each connection is one HubSpot account (portal). Ryze AI can hold several portals in one workspace through View, then Add one more account. One is the primary (star) and is used unless you name another, and the tools accept an optional connection_id.
- Which workspaces
- On the Ryze AI page that Grok opens you choose workspaces and click Allow connection. Grok can use the HubSpot connection saved in the workspaces you allowed.
Sources: the Ryze AI HubSpot guide and HubSpot's API usage guidelines.
Removing access
To stop Grok from reaching HubSpot, click View on the HubSpot card in Ryze AI and disconnect the account, or remove the Ryze AI connector on grok.com/connectors (admins remove the team connector in the console).
What Grok can do in HubSpot
Ryze AI exposes 5 HubSpot tools to Grok. They run as the HubSpot account you connected, so that account's permissions set the limit.
| Tool | Type | What it does |
|---|---|---|
| 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__search | Read | Searches CRM records through the HubSpot CRM Search API with filter groups, sorts, a text query and chosen properties. |
| 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__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. |
The xAI pages checked do not describe a per-tool approval setting for custom connectors, so this page does not claim one. A prompt that asks Grok to show a change and wait for your answer is an instruction to the model. The Ryze AI chat has its own Tool approvals setting, which starts on Skip all approvals; switch it to Approve write & delete or Manual approve to confirm changes. Scheduled tasks run without an approval step. If Grok should only read, connect HubSpot with a login whose reach you are comfortable sharing and ask read-only questions.
First 3 prompts to run
Each prompt below describes what to ask. Answers come from your own HubSpot account, so the page shows no sample numbers.
1. Pull open deals with filters
Search my HubSpot deals for ones I own that are not closed, and list each with its name, amount, stage and close date.
Tools used: hubspot__search
What comes back: A list of deals that match the filters, with the properties you named. HubSpot returns a default subset of properties unless you ask for specific fields.
2. List contacts with their owners
List the HubSpot contacts created this month with name, lifecycle stage and contact owner, and look up the owner names.
Tools used: hubspot__listObjects, hubspot__read
What comes back: Contacts from the connected account with the properties you chose, and owner details from HubSpot's owners resource.
3. Review a change before it is written
Show me the HubSpot deal I name next with its current stage and amount. Then tell me what you would change to move it to the next stage, and wait for my yes before writing.
Tools used: hubspot__read, then hubspot__write after you confirm
What comes back: The deal's current properties and a proposed update. The write happens only after you confirm, because you asked Grok to wait.
Name the real deal in the third prompt. HubSpot returns only a default set of properties unless the prompt names the fields it needs.
Ryze AI vs HubSpot's own MCP server
HubSpot runs its own remote MCP server. It suits different clients and jobs than the Ryze AI connector.
| Option | Setup | HubSpot coverage | Auth | Listed clients |
|---|---|---|---|---|
| Ryze AI connector | Connect HubSpot in Ryze AI, then add https://connector.get-ryze.ai/mcp as a custom connector in Grok | 5 tools: search, list and read CRM records, owners, lists and blog posts, plus create, update and delete of CRM records and blog posts when asked; several portals per workspace | Ryze AI sign-in; HubSpot OAuth in Ryze AI | Grok on grok.com, Grok Bot and Grok Build, plus Claude, ChatGPT and others in the Ryze AI client list |
| HubSpot remote MCP server | Create an MCP connector in your HubSpot account under Development, then MCP Connectors, and point an MCP client at https://mcp.hubspot.com | Broader object coverage in HubSpot's docs: contacts, companies, deals, tickets, leads, custom objects, activities, blog posts, landing pages and campaigns, with write support for many of them | OAuth 2.0 with PKCE, required by HubSpot | HubSpot's docs name Claude, ChatGPT, Gemini and Perplexity (for AEO data only); Grok is not named |
HubSpot says its server works with any MCP client that supports OAuth with PKCE. Whether grok.com handles that flow for a custom connector is not verified here. HubSpot's docs do not state rate limits for the server. If you want Grok to reach HubSpot, the Ryze AI connector is the path this page documents.
Sources: HubSpot remote MCP server, Ryze AI HubSpot guide and xAI Grok connectors. Checked November 15, 2026.
Errors and fixes
- Grok does not list the HubSpot tools
- If HubSpot was connected after the connector was added, remove the Ryze AI connector in Grok, add it again and start a new chat.
- HubSpot refuses the install
- Sign in with a login that can approve the requested permissions, or ask a HubSpot admin for the account to approve it. Check that you chose the right account (portal) on the Choose Account screen.
- A record shows fewer fields than expected
- HubSpot returns a default subset of properties unless specific fields are requested. Name the properties in the prompt.
- A CMS source-code file will not load
- CMS source-code file endpoints return raw files and fail through the read tool. Ask for blog content instead.
- The wrong HubSpot account answers
- Each connection is one portal. If several are connected, the primary (star) account is used unless you name another. Name the account in the prompt or change the primary under View on the HubSpot card.
- The connector will not add on grok.com
- grok.com needs the MCP server to be reachable over the public internet. The Ryze AI URL is public, so check for a typo in https://connector.get-ryze.ai/mcp. On Grok Business and Enterprise, ask a team admin to add it in the console first.
- Ryze AI shows as Disabled by team admin in Grok Bot
- A team connector policy blocks the app. Ask the team admin to allow it.
- Tools show up twice in Grok Bot
- You may have both the built-in Ryze AI app and an older custom server. Uninstall the custom copy.
- The tools say a subscription is required
- The HubSpot tools need an active Ryze AI plan or free trial. Start the trial in Ryze AI, then retry.
- A deleted blog post cannot be restored
- Deleted blog posts may not be recoverable. Most CRM deletes go to HubSpot's recycling bin. Ask Grok to delete only when you mean it.
Frequently asked questions
What is the best way to connect Grok to HubSpot?
Ryze AI is the best way to reach HubSpot CRM records from Grok with one connector URL, though HubSpot's own server at https://mcp.hubspot.com covers more object types. HubSpot's docs name Claude, ChatGPT, Gemini and Perplexity as clients and do not name Grok.
How do I connect Grok to HubSpot?
Connect HubSpot in Ryze AI under Integrations: click Connect on the HubSpot card, sign in, choose the account and approve the permissions. Then go to grok.com/connectors, click New Connector, choose Custom, enter https://connector.get-ryze.ai/mcp, sign in on the Ryze AI page, choose workspaces and click Allow connection.
Does HubSpot have its own MCP server?
Yes. HubSpot hosts a remote server at https://mcp.hubspot.com and requires OAuth 2.0 with PKCE. You create the connector in your HubSpot account under Development, then MCP Connectors. Whether grok.com accepts it as a custom connector is not verified here.
Do I need a paid Grok plan?
xAI says connectors on grok.com, including custom MCP connectors, are available to all Grok users. Grok Business and Enterprise need a team admin to add the connector first. Grok Bot is a separate surface that xAI includes in X Premium, Super and Ultra and not in Plus.
Do I need a paid Ryze AI plan?
Connecting is free, but the HubSpot tools need an active plan or free trial. Paid Ads is $89 per month with a 7-day free trial, Agency is $279 per month, and SEO Starter is $129 per month with a 3-day free trial. Annual billing takes 30% off the first year.
What HubSpot permissions does Ryze AI ask for?
Required groups are contacts, companies and deals read and write, owners read, contact schema read, deal schema read and write, lists read and content. Optional groups are files, CMS functions, knowledge base and membership. HubSpot's consent screen shows the exact list.
Can Grok edit or delete things in HubSpot?
Yes. Through Ryze AI it can create or update contacts, companies, deals and blog posts and add associations between records. It can delete (archive) records or blog posts when explicitly asked. Most CRM deletes go to the recycling bin, and deleted blog posts may not be recoverable.
Can Grok edit contact lists or custom objects?
Lists are read-only through Ryze AI. Custom object support is not claimed on this page, because the permissions Ryze AI requests do not include custom-object scopes.
Does this work in Grok Bot and Grok Build?
Yes. In Grok Bot open Connect apps and add Ryze AI, or add the URL as a custom MCP server if it is missing. In Grok Build run grok mcp add --transport http ryze https://connector.get-ryze.ai/mcp and finish the browser sign-in.
Can I connect more than one HubSpot account?
Yes. Ryze AI holds several HubSpot portals in one workspace. Click View on the HubSpot card, then Add one more account. One is the primary (star) and is used unless you name another.
How do I disconnect Grok from HubSpot?
Remove the Ryze AI connector on grok.com/connectors, or click View on the HubSpot card in Ryze AI and disconnect the account.