By Ira Bodnar, Ryze AI · Updated · Connector tested November 14, 2026
Quick answer
The main way to connect Antigravity to HubSpot is the Ryze AI connector. Connect your HubSpot portal in Ryze AI with HubSpot's own OAuth sign-in, then add a ryze entry with the serverUrl https://connector.get-ryze.ai/mcp to Antigravity's mcp_config.json and finish the Ryze AI sign-in. The agent then has 5 HubSpot tools: three that read (list, search and a general read), one that writes and one that deletes. No HubSpot app of your own is needed.
- In HubSpot, make sure your user is a Super Admin or has App Marketplace access
- In Ryze AI open Integrations, click Connect on the HubSpot card, choose the portal and approve the permissions
- In Antigravity open MCP Servers, Manage MCP Servers, View raw config and add the ryze entry
- Complete the Ryze AI sign-in, start a new agent chat and ask it to search your open deals
Antigravity to HubSpot at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector: a hosted MCP server that Antigravity reaches through one serverUrl entry. The HubSpot sign-in happens once inside Ryze AI and nothing runs on your machine |
| Server address | https://connector.get-ryze.ai/mcp |
| Where the entry goes | mcp_config.json, either ~/.gemini/config/mcp_config.json for every project or .agents/mcp_config.json in one workspace. The IDE, the App and the CLI read the same format |
| Sign-in | Two separate sign-ins. HubSpot uses OAuth inside Ryze AI: sign in, choose the portal, approve the permissions. Antigravity then signs in to the connector with OAuth 2.0 and PKCE, with no client ID to enter |
| HubSpot tools | 5 in all: hubspot__listObjects, hubspot__search, hubspot__read, hubspot__write and hubspot__delete |
| Which portal | One HubSpot portal per connection. Several portals can sit in one Ryze AI workspace, and the starred one is used unless you name another |
| Can it change things | Yes. The write tool creates or updates contacts, companies and deals and adds associations, and the delete tool archives a record by ID. Antigravity holds MCP tools without a rule in Ask mode, so each call waits for a click |
| Other data in the same chat | Tools for the other platforms you connect in the same Ryze AI workspace appear under the same address. This guide covers HubSpot only |
| Antigravity plan needed | None is named. Google's MCP page lists no plan |
| Ryze AI price | Connecting costs nothing, and the tools need an active plan or trial: Paid Ads is $89 per month with a 7-day free trial, SEO Starter $129 per month with a 3-day free trial, Agency $279 per month |
| HubSpot's own option | A hosted MCP server at https://mcp.hubspot.com with 36 tools. It needs an MCP connector created in HubSpot with a client ID and secret. HubSpot's pages do not name Antigravity, and the pairing was not tested here |
| Last tested | 11 read-only HubSpot calls through the connector on November 14, 2026, run from Claude Code. Nothing was run inside Antigravity |
Before you start
- Google Antigravity. Google's MCP page names no plan. It covers the standalone IDE, the desktop App and the CLI, and all three read one mcp_config.json format. The standalone IDE is not supported on enterprise accounts, and an admin may have to allow MCP servers first.
- A HubSpot user who can install apps. HubSpot says installing an app needs Super Admin or App Marketplace access permissions. Ryze AI has a listing in the HubSpot Marketplace, and the Ryze AI help center says you can start from it. The portal then decides which parts work: HubSpot lists the content scope, used for blog posts, for CMS Hub or Marketing Hub Professional or Enterprise accounts only.
- A Ryze AI workspace on a plan or free trial. Paid Ads is $89 per month with a 7-day free trial, SEO Starter is $129 per month with a 3-day free trial and Agency is $279 per month. Connecting is free; the HubSpot tools need an active plan or trial. Annual billing takes 30% off the first year.
How to connect Antigravity to HubSpot
These steps are for the Antigravity IDE. Two happen in HubSpot and Ryze AI, four in the editor. The App and the CLI use the same config entry and are covered below.
Check your HubSpot permission
In HubSpot the person who connects needs to be a Super Admin or have App Marketplace access. If you are neither, ask a Super Admin to connect, or to turn on the App Marketplace access switch for your user.
Connect HubSpot in Ryze AI
In the Ryze AI app open Integrations, find the HubSpot card and click Connect. Sign in to HubSpot, choose the account (portal), click Choose Account and approve the permissions. HubSpot then returns you to Ryze AI with the connection saved.
Open the raw MCP config in the Antigravity IDE
In the agent side panel of the editor, click the ... menu at the top and choose MCP Servers. Click Manage MCP Servers, then View raw config. This opens mcp_config.json: ~/.gemini/config/mcp_config.json covers every project and .agents/mcp_config.json covers one workspace.
Add the ryze entry
Under mcpServers add an entry named ryze with the serverUrl https://connector.get-ryze.ai/mcp and save. No client ID or secret goes in the file, because the Ryze AI connector offers dynamic client registration and Antigravity registers itself.
Sign in to Ryze AI
Antigravity starts the browser sign-in for the server, and Google's MCP page does not describe how it begins in the IDE. On the Ryze AI page pick the workspace that holds your HubSpot connection and click Allow connection. If the entry was added before HubSpot was connected, remove it, add it again and open a new chat so the tool list refreshes.
Ask your first question
Open a new agent chat and ask: Search HubSpot deals created in the last 30 days and show name, amount and stage. Antigravity asks for approval before an MCP tool runs until you allow it, so approve the first call.
The Ryze AI help article for HubSpot covers the HubSpot sign-in, the portal choice and the optional blog and author picker. There is no Ryze AI help page for Antigravity, and Ryze AI was not tested in it for this page.
Sources: Google's Antigravity MCP documentation, checked November 15, 2026, and the Ryze AI HubSpot guide.
Antigravity App
The Antigravity App keeps its MCP servers on the Customizations page and has an Authenticate button of its own, so the sign-in differs from the IDE. One layout matters: in the Knowledge Work layout the Installed tab lists plugins only and the MCP Servers section is hidden. Choose Software Engineering under Settings > General > Interface Layout first. Business and enterprise accounts always use Software Engineering.
- Click Customizations in the sidebar, then Installed, and scroll down to MCP Servers.
- Click Copy Config File Path and add the ryze entry shown below to that mcp_config.json.
- Go back to Customizations, Installed, MCP Servers and click Authenticate next to ryze.
- Sign in to Ryze AI in the browser, copy the authorization code, paste it into Enter authorization code and click Submit. The server reconnects by itself.
The entry to add is the same in the IDE, the App and the CLI:
{
"mcpServers": {
"ryze": {
"serverUrl": "https://connector.get-ryze.ai/mcp"
}
}
}The App's Add MCP Server (+) button opens a searchable catalog with no address field, so a custom server goes into mcp_config.json by hand. Remote servers must use Streamable HTTP: Google's docs reject the older HTTP+SSE transport and the httpUrl key, and accept url as another name for serverUrl. Antigravity's OAuth redirect URI is https://antigravity.google/oauth-callback.
Antigravity CLI
The Antigravity CLI (agy) reads the same two files. Put the ryze entry in ~/.gemini/config/mcp_config.json or in <workspace>/.agents/mcp_config.json, then type /mcp in the prompt panel to open the MCP Manager, which shows a status line per server and reloads the configuration. Use a different name for a workspace entry than for a global one, because when two files share a name the server already running wins. The CLI replaced Gemini CLI for personal accounts.
Google documents the Authenticate steps for the App only. The CLI changelog mentions a sign-in link for OAuth servers (version 1.5.2, November 6, 2026), but no Google page lists CLI sign-in steps, so none are given here. The changelog also names mcp add, remove, list, enable and disable subcommands without their syntax, so none is shown. OAuth tokens are kept in ~/.gemini/antigravity/mcp_oauth_tokens.json and refreshed automatically.
Sources: Google's Antigravity MCP documentation, the Gemini CLI to Antigravity CLI update, the Gemini CLI migration page, the Antigravity changelog and the connector checks on this page. Checked November 15, 2026.
Antigravity and MCP: the facts in one table
| Topic | What Google's Antigravity pages say |
|---|---|
| Where MCP works | The MCP page covers the Antigravity App, the CLI and the standalone IDE. The Visual Studio extension page describes the same two mcp_config.json files |
| Config format | An mcpServers map keyed by server name, identical on every surface. An enabled plugin can ship servers in its own <plugin-root>/mcp_config.json |
| Local or remote | command starts a local stdio process. serverUrl (or url) points at a remote Streamable HTTP server |
| Extra headers | A headers object on a remote entry sends custom HTTP headers, such as an Authorization bearer token |
| OAuth order | oauth.clientId (and an optional clientSecret) from the file first, then a Client ID Metadata Document, then dynamic client registration. The Ryze AI connector lists a registration endpoint and no metadata document, so the third route applies |
| Approvals | An MCP tool with no rule waits in Ask mode. Rules are written mcp(server/tool), mcp(server/*) or mcp(*), and Deny beats Ask beats Allow |
| Skipping the prompt | Turbo in the App on a personal account runs MCP tools without asking. In the CLI, request-review is the default and always-proceed skips the prompt unless an ask or deny rule matches |
| Trimming a server | enabledTools keeps only the tools you list, disabledTools hides listed ones, and disabled: true pauses a server but keeps its entry |
| Tool loading | Tools load lazily by default and their schemas are cached on disk |
| Timeouts | Up to 5 minutes for a server to connect and list tools and up to 3 minutes per tool call, both set by timeoutSeconds |
| Plan and enterprise | No plan is named for MCP. The standalone IDE is unsupported for enterprise deployments, and admins can set MCP allowlists |
| Bringing servers over | The App can import MCP servers from Claude Code, Codex and Cursor into a plugin you own, per the v2.30.0 changelog entry |
Sources: MCP, permissions, settings, plans, enterprise, getting started, Visual Studio extension and changelog pages of Google Antigravity. Checked November 15, 2026.
Other AI clients
The same URL works in other MCP clients. HubSpot is connected once in Ryze AI, so nothing changes on the HubSpot side.
Gemini
Google's other assistant takes the same URL with different steps. See How to connect Gemini to HubSpot. For the Antigravity client in general, see Ryze AI in Antigravity.
Claude Code, Codex and Cursor
Each coding client has its own guide: Claude Code, Codex and Cursor.
Claude and ChatGPT
Both add the URL as a custom connector. See How to connect Claude to HubSpot and How to connect ChatGPT to HubSpot.
HubSpot access and permissions
Access comes from the HubSpot app install, not from Antigravity. Antigravity signs in to the Ryze AI connector, and the scopes approved on the HubSpot consent screen set what the connection can reach. Four points cover it.
- An OAuth app install
- HubSpot is joined with HubSpot's OAuth: you sign in, choose the portal and approve the permissions. No API key or private app token is pasted anywhere. Ryze AI's Shared Data list in the HubSpot Marketplace names eight data types: Contacts, Contact Properties, Companies, Deals, Deal Properties, Contact Lists, Owners and CMS Blog Post.
- Who can install
- HubSpot says a user must be a Super Admin or have App Marketplace access permissions to install an app. Everyone else needs a Super Admin to do it.
- Scopes, not the installer's record rights
- HubSpot's OAuth guide says an access token reflects the scopes the app requested and not what the installing user can do. A user who can see only owned contacts but approves crm.objects.contacts.read gives the app a token that can view all contacts in the account.
- One portal per connection
- Each connection is one HubSpot portal. Several portals can be connected to one Ryze AI workspace, one is the primary, and the tools accept an optional connection_id to pick another.
The HubSpot scopes behind the connection
Antigravity signs in to the connector, and the connector's discovery data names two scopes for that sign-in, mcp:read and mcp:write. The scopes below belong to the HubSpot install. Ryze AI's facts list contacts, companies and deals read and write, owners read, contact and deal schema read, deal schema write, lists read and content as required, with files, CMS functions, knowledge base and membership as optional. The third column is HubSpot's own wording for each scope.
| HubSpot scope | What it covers | Availability per HubSpot |
|---|---|---|
| crm.objects.contacts.read and .write | View properties and other details about contacts. Write adds create, delete and change. | All accounts |
| crm.objects.companies.read and .write | View properties and other details about companies. Write adds create, delete and change. | All accounts |
| crm.objects.deals.read and .write | View details about deals. Write adds create, delete and change. | All accounts |
| crm.objects.owners.read | View details about the users assigned to a CRM record. | All accounts |
| crm.schemas.contacts.read | View details about property settings for contacts. | All accounts |
| crm.schemas.deals.read and .write | View details about property settings for deals. Write adds create, delete and change. | All accounts |
| crm.lists.read | View details about contact lists. | All accounts |
| content | Access to the content APIs, including website pages, landing pages and blog APIs. | CMS Hub Professional or Enterprise, or Marketing Hub Professional or Enterprise accounts only |
| files (optional) | A legacy scope for the HubSpot file manager. HubSpot recommends the granular files scopes for existing apps. | All accounts |
The scope names and descriptions are HubSpot's, from its scopes reference. Which optional scopes the Ryze AI consent screen asks for was not opened for this guide, so check the permissions list HubSpot shows before you click approve.
What the default connection does not include: tickets (a ticket search through the connector came back with status not_allowed on the test portal), custom object records (the requested scopes include no custom-object scope), adding or removing contacts in a list (lists are read only), and theme or template source files in the CMS, which return raw files and fail through the read tool. A second portal needs its own connection in the same workspace.
Sources: HubSpot scopes, working with OAuth, installing apps and the Ryze AI Marketplace listing, checked November 14, 2026. Ryze AI's connection details from the Ryze AI HubSpot guide.
Limits that shape the answers
These limits shape what comes back. The first four come from Ryze AI's connection facts and the 11 test calls, and the last three from Google's Antigravity MCP page.
| Area | Limit |
|---|---|
| One portal | A connection holds one HubSpot portal. Add more with View, then Add one more account, and name the one you want in the prompt. |
| Default properties | HubSpot returns a default subset of properties unless you name the fields. Ask for the properties you want by their internal names. |
| Page sizes in the tool definitions | hubspot__listObjects takes a limit of up to 100 and hubspot__search a limit of up to 200. Paths on the read, write and delete tools can be 2,048 characters long. |
| Active plan | Without an active Ryze AI plan or trial the connector can only list workspaces and connect platforms. |
| Timeouts | Antigravity waits up to 5 minutes for a server to connect and list its tools and up to 3 minutes for each tool call. |
| Tool loading | MCP tools load lazily and their schemas are cached on disk, so the agent reads them when needed. |
| Tool approval | An MCP tool without a configured rule runs in Ask mode, and each call needs your approval until a policy allows it. |
Sources: the Ryze AI HubSpot guide, the Ryze AI connection facts and Google's Antigravity MCP documentation, checked November 15, 2026.
Removing access
To remove access, disconnect HubSpot on its card in Ryze AI, or uninstall the Ryze AI app inside HubSpot, which HubSpot documents as removing the app's access. In Antigravity delete the ryze entry from mcp_config.json, or set disabled: true to pause it and keep the entry. In the App, More actions (⋮) next to the server offers Disable and Delete. Stored OAuth tokens are in ~/.gemini/antigravity/mcp_oauth_tokens.json.
What Antigravity can do in HubSpot
The Ryze AI connector exposes 5 HubSpot tools. All five definitions were loaded from the connector by name on November 14, 2026 and match Ryze AI's facts. The definitions name contacts, companies and deals as the object types.
| 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. Takes a limit of up to 100. |
| hubspot__search | Read | Searches CRM records through the HubSpot CRM Search API with filter groups, sorts, a text query and chosen properties. Takes a limit of up to 200. The definition lists the operators EQ, NEQ, GT, GTE, LT, LTE, BETWEEN, IN, NOT_IN, HAS_PROPERTY, NOT_HAS_PROPERTY and CONTAINS_TOKEN. |
| 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. CMS source-code file endpoints return raw files and fail here. |
| hubspot__write | Write | Creates or updates a HubSpot resource, such as a contact, company, deal or blog post, and adds associations between records. The definition lists CREATE and UPDATE. |
| hubspot__delete | Delete | Deletes (archives) a HubSpot resource by ID. Most CRM deletes go to HubSpot's recycling bin, and deleted blog posts may not be recoverable. |
In Antigravity an MCP tool with no rule waits in Ask mode, so each call needs a click. Google's rule forms are mcp(server/tool) and mcp(server/*). Allow hubspot__search and hubspot__listObjects if you want those reads to run freely, and keep hubspot__write and hubspot__delete in Ask mode. In the Ryze AI chat the Tool approvals setting starts on Skip all approvals, and Approve write & delete or Manual approve can be chosen there. Scheduled tasks run without an approval step.
HubSpot limits in numbers
HubSpot meters its API per account, and the search API has its own caps. Ryze AI's facts do not say how its connection maps onto these quotas. The first row is HubSpot's rule for OAuth apps distributed through its Marketplace, which Ryze AI is, but no HubSpot page applies it to Ryze AI and no response in the test carried a rate limit header. Treat the figures as HubSpot's published limits.
| Limit | Figure or rule | Who sets it |
|---|---|---|
| Burst limit for Marketplace OAuth apps | 110 requests every 10 seconds for each HubSpot account that installs the app, not counting the CRM Search API. The API limit increase add-on does not raise it | HubSpot |
| CRM Search API rate | 5 requests per second per account. Search responses carry none of the rate limit headers | HubSpot |
| Search page size | 10 records per page by default and at most 200. A request for 201 came back as Error 400 VALIDATION_ERROR through the connector | HubSpot |
| Search result cap | 10,000 results for any one query. Paging past it returns a 400 error | HubSpot |
| Search filters | At most 5 filterGroups with up to 6 filters each, 18 filters in all. Filters in a group are joined with AND and groups with OR | HubSpot |
| Search query length | At most 3,000 characters. A longer request body returns a 400 error | HubSpot |
| Search freshness | New or updated records can take a few moments to appear. Archived records never appear in search results | HubSpot |
| List page size | Up to 100 contacts in one list request, paged with the after value | HubSpot |
| Access token life | OAuth access tokens expire after 30 minutes and the app refreshes them with the refresh token | HubSpot |
| Rate limit error | 429 for all further calls once a limit is passed. The daily limit resets at midnight in the account's time zone | HubSpot |
| Recycling bin | Deleted records can be restored for up to 90 days. Permanent or GDPR deletions skip the bin and can take up to 30 days to be purged | HubSpot |
| Tool wait in Antigravity | Up to 3 minutes per tool call and 5 minutes to connect, adjustable with timeoutSeconds | Antigravity |
Sources: HubSpot's usage guidelines, CRM search guide, contacts guide, OAuth tokens and restoring deleted records, checked November 14, 2026. The tool and test figures from the Ryze AI connector calls of November 14, 2026. The Antigravity figure from the Antigravity MCP documentation, checked November 15, 2026.
First 3 prompts to run
1. Search deals by age
Search HubSpot deals created in the last 30 days and show the deal name, amount and stage, 50 per page.
Tools used: hubspot__search
What comes back: A list of deals from your own portal with the three properties you named. An empty search comes back as a total of 0 and no results.
2. Find a company and what is attached to it
Find the HubSpot company with the domain example.com, then list its associated contacts and deals.
Tools used: hubspot__search, hubspot__listObjects
What comes back: The matching company record and the IDs of the contacts and deals linked to it, with the properties you ask for. Without named properties HubSpot returns its default set.
3. Check the property names first
Read the contact property definitions from HubSpot and list the internal names of the lifecycle and lead status properties.
Tools used: hubspot__read
What comes back: The property definitions HubSpot holds for contacts. The internal names are what a search filter needs, and HubSpot rejects a filter on a name that does not exist.
Each answer comes from your own portal, so this page describes what comes back instead of showing sample records. The 11 calls run on November 14, 2026 were read-only searches and lists that returned empty or one-record results, and none is reproduced here.
10 jobs to hand to Antigravity
Ten jobs to hand to the Antigravity agent, each with the Ryze AI tool that does the work. The last column follows the pack's reading of the default connection. Every job needs an active Ryze AI plan or trial, and only searches and lists were run against a portal.
| Job | Ask the agent | Tool | Works on the default connection |
|---|---|---|---|
| Find a contact | Find the contact with this email address and show the properties I name. | hubspot__search | Yes. A contacts search by email ran and returned a valid empty result |
| Recent deals | List deals created in the last 30 days with name, amount and stage. | hubspot__search | Yes. A deals search ran and returned a valid result |
| Stalled deals and owners | Find open deals with no change in 30 days and show the owner of each. | hubspot__search, then hubspot__read on crm/v3/owners | Yes. The search ran. The owners read was not run |
| Company with its contacts and deals | Find a company by domain and list its associated contacts and deals. | hubspot__search, then hubspot__listObjects | Yes. A companies search ran. Associations were not requested in the test |
| Page through contacts | List contacts page by page with lifecycle stage and create date. | hubspot__listObjects | Yes. A one-record list ran and returned a paging cursor |
| Property check before a filter | Show which contact and deal properties exist before you build a filter. | hubspot__read on crm/v3/properties/contacts or crm/v3/properties/deals | Yes, by the facts and scopes. Not run |
| Read a list | Read this contact list and its details. | hubspot__read on crm/v3/lists/{listId} | Yes for reading. Lists are read only, and the read was not run |
| Create a deal | Create a deal and associate it with this company and contact. | hubspot__write | Yes by the facts. Not run, because it changes the portal |
| Update a property | Update this property on the contact, company or deal. | hubspot__write | Yes by the facts. Not run |
| Delete a duplicate | Delete the duplicate contact with this ID. I confirm. | hubspot__delete | Yes by the facts when you ask by ID. Not run. HubSpot restores deleted records from the recycling bin for up to 90 days |
Jobs the connection does not cover in Ryze AI's facts: searching or updating tickets, custom object records, adding contacts to a list, and reading theme or template code files. Blog post reads and writes are in the facts, but the two blog reads in the test used made-up IDs and returned an HTML 404, so whether they work on every portal tier was not confirmed.
5 ways to connect Antigravity to HubSpot
Five ways can give the Antigravity agent your HubSpot data. This guide treats the first, the Ryze AI connector, as the main way: Antigravity stores one serverUrl entry, HubSpot is joined by OAuth in Ryze AI and you create no HubSpot app. The others were read on their own pages on November 14, 2026 and none was installed for this guide, so the setup column states what each page says and how it would fit Antigravity's mcp_config.json.
| Way | Runs where | Setup | What it reaches in HubSpot | Price |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Hosted by Ryze AI, one address for Antigravity, Claude, ChatGPT and other MCP clients | Connect HubSpot in Ryze AI with OAuth, then add a ryze entry with serverUrl https://connector.get-ryze.ai/mcp and sign in | 5 tools: list, search, read, write and delete. Contacts, companies and deals, plus owners, property definitions, lists and blog posts through the read tool. One portal per connection | Free to connect. The tools need an active plan or trial: Paid Ads $89 per month with a 7-day free trial, SEO Starter $129 per month with a 3-day free trial, Agency $279 per month |
| HubSpot remote MCP server | HubSpot hosts it at https://mcp.hubspot.com | In HubSpot go to Development, MCP Connectors and create a connector with a name and a redirect URL. HubSpot generates a client ID and secret. The server needs a client that supports OAuth with PKCE. Antigravity's file accepts oauth.clientId and an optional clientSecret, and its documented redirect URI is https://antigravity.google/oauth-callback, but HubSpot's pages do not name Antigravity and the pairing was not tested | 36 tools on HubSpot's page of November 14, 2026: CRM search and read, activities, blog posts, landing pages, site pages, campaigns, content analytics, segments, and creating or editing records. No delete tool in the documented list. Search returns up to 200 results per page | No price stated on the page |
| Composio | Hosted by Composio at https://connect.composio.dev/mcp | Connect HubSpot in Composio with its managed OAuth app, your own app or an API key, then add the address as a serverUrl entry and authenticate. Composio's pages name Claude, Cursor and ChatGPT, and Antigravity was not found on them | The HubSpot toolkit lists 354 tools and 2 triggers, read and write, including batch create, update and archive | Free $0 with 10,000 tool calls per month, Standard $18 per seat per month, extra calls $0.005 each. The toolkit FAQ quotes a different free allowance, so check both pages |
| Zapier MCP | Hosted by Zapier at https://mcp.zapier.com/api/v1/connect | Create a Zapier MCP server, enable HubSpot actions and connect with OAuth, or with a connection token for clients without a setup page. Antigravity is not in the client lists seen | The HubSpot actions you enable from your Zapier account. Zapier prints no total | No separate MCP price. Each successful tool call uses 2 tasks from the Zapier plan, and failed calls use 0. Free plan 100 tasks per month, Professional from $19.99 per month billed annually at 750 tasks |
| Windsor.ai MCP | Hosted by Windsor.ai | Add HubSpot as a data source in Windsor.ai, then add Windsor MCP to the assistant. Its guides name Claude, ChatGPT, Copilot, Gemini CLI, Perplexity and Cursor, not Antigravity | Reporting access to HubSpot data: the connector exposes 1,141 fields (287 metrics, 854 dimensions). Whether it can write to HubSpot is not stated | Included on every plan. Free forever plan with 1 user, 1 data source and 1 account. Basic $23 per month on monthly billing |
HubSpot's own server is wider than the Ryze AI one, with 36 tools against 5, and HubSpot says its connectors for Claude, Microsoft Copilot, Gemini and ChatGPT run on it. It asks for a client ID and secret that you create, where the Ryze AI route asks for none. Composio and Zapier reach HubSpot through a third party, so their limits and prices come from their plans. Windsor.ai fits reporting on HubSpot data more than record edits.
Options that do not fit Antigravity
- HubSpot connectors for ChatGPT, Claude, Gemini and Copilot. HubSpot's own connectors install inside those assistants and do not run in Antigravity. The Gemini connector is read-only and needs a paid Google Workspace plan, and the connectors for ChatGPT and Claude list no delete action.
- HubSpot Developer MCP server. A local server installed with hs mcp setup that gives a coding agent HubSpot's developer docs and project tools, 23 tools in all. HubSpot lists Gemini CLI, Claude Code, Codex CLI, Cursor, VS Code and Windsurf for it, not Antigravity, and it has no CRM record tools.
- @hubspot/mcp-server on npm. HubSpot's earlier local server, in beta since May 6, 2025, with 21 tools and a private app access token. Version 0.4.0 of June 18, 2025 is still the latest. HubSpot announced that creating new legacy private apps is disabled from September 28, 2026 for new accounts and October 26, 2026 for existing ones, and whether a Service Key token works with this package is not stated.
- HubSpot Agent CLI. A beta command-line tool that an agent runs to create, read, update and delete CRM records, with a dry-run mode. HubSpot names Claude Code, Claude Cowork and OpenAI Codex for it, and the skills repository names Cursor and Windsurf. Antigravity is not named.
- Coupler.io MCP. Read-only analysis of HubSpot datasets loaded by your own Coupler.io data flows, handed to the AI as aggregated data. Its pages disagree on which plan includes it.
- Antigravity's MCP Store and Plugin Marketplace. The IDE installs catalog servers from its MCP Store and the App and CLI from the Plugin Marketplace, open since October 29, 2026. Ryze AI is not one of the 77 servers on Google's MCP page, and no catalog was searched for a HubSpot entry.
Which one to pick
Ryze AI is the best way to connect Antigravity to HubSpot for searching and editing contacts, companies and deals through one URL with no HubSpot app of your own, with three caveats: it has 5 tools against the 36 on HubSpot's own server, it leaves out tickets, custom objects and list editing, and the tools need a Ryze AI plan once the trial ends. Pick HubSpot's own server when you want its wider tool list and are ready to create an MCP connector and test the sign-in with Antigravity yourself. Pick Composio or Zapier when you already pay for them, and Windsor.ai for reporting. The Ryze AI connector and HubSpot's server can sit in one mcp_config.json under different names.
Sources: HubSpot remote MCP server docs, Developer MCP setup, @hubspot/mcp-server on npm, Agent CLI article, connector for ChatGPT, connector for Claude, connector for Gemini, Composio HubSpot toolkit, Composio pricing, Zapier MCP for HubSpot, Zapier MCP usage, Windsor MCP and Coupler.io MCP for HubSpot, checked November 14, 2026. Antigravity setup and catalogs from the Antigravity MCP documentation, checked November 15, 2026.
HubSpot, Antigravity and MCP: dates that matter
| Date | Event |
|---|---|
| May 6, 2025 | HubSpot announced its MCP server in public beta as an npm package used with a private app access token. |
| June 18, 2025 | @hubspot/mcp-server 0.4.0 was published. It is still the latest version on November 14, 2026. |
| November 18, 2025 | Google Antigravity shipped as an AI-powered IDE. The launch entry does not mention MCP. |
| December 16, 2025 | A Google Cloud blog post showed installing Google Cloud MCP servers from the Antigravity MCP Store, the oldest dated Google page on Antigravity and MCP that the research found. |
| February 19, 2026 | HubSpot's local Developer MCP server became generally available. |
| April 13, 2026 | HubSpot's remote MCP server became generally available to all accounts, with write access added and OAuth with PKCE required. |
| May 19, 2026 | Google released the Antigravity App and the Antigravity CLI and began moving Gemini CLI users to the CLI. |
| June 29, 2026 | HubSpot added content analytics and landing page creation to its remote MCP server. |
| August 27, 2026 | HubSpot announced that creating legacy private apps is disabled, from September 28, 2026 for new accounts and October 26, 2026 for older ones. Service Keys are the replacement. |
| September 15, 2026 | HubSpot's Fall 2026 Spotlight added custom objects, activable objects and Leads to its MCP server and Claude connector. The same day it announced the end of support for API versions v1 to v3 (enforced in September 2027) and for v4 (March 30, 2027). |
| October 29, 2026 | The Plugin Marketplace opened in the Antigravity App and CLI. |
| October 30, 2026 | HubSpot put AI connector access to Sensitive Data in public beta for ChatGPT, Claude and Copilot, and engagements only for Gemini and its remote MCP server. |
| November 6, 2026 | Antigravity CLI 1.5.2 fixed MCP OAuth sign-ins that failed with Invalid PKCE code_verifier when a server reconnected mid sign-in. |
| November 9, 2026 | Antigravity App 2.30.0 added the Knowledge Work layout that hides the MCP Servers list, and an import of MCP servers from other coding tools. |
Sources: MCP server beta post, npm registry, Developer MCP server GA, remote MCP server GA, June 2026 rollup, legacy private app sunset, Fall 2026 Spotlight, API version support and October 2026 rollup, checked November 14, 2026; Antigravity changelog, Google Cloud blog, December 2025, Google Developers Blog, May 2026 and Antigravity blog, October 2026, checked November 15, 2026.
How this guide was tested
Three sets of checks stand behind this guide. On November 14, 2026, 11 read-only HubSpot calls were run through the Ryze AI connector from Claude Code against an already connected portal, and the HubSpot sources named on this page were opened. On November 15 the connector's sign-in data was compared with the OAuth order in Google's Antigravity docs. Nothing about the portal or its records is recorded here.
| Check | Result |
|---|---|
| Tool list, November 14 | All five definitions (hubspot__listObjects, hubspot__search, hubspot__read, hubspot__write, hubspot__delete) loaded by name from the connector and match Ryze AI's facts. Every tool takes a workspace argument and an optional connection_id. |
| Searches on contacts, companies and deals | 6 hubspot__search calls were made. The three filtered on a random string and each came back as {"total":0,"results":[]}. The other three were refused: a filter on a missing property, a limit of 201 and a ticket search. |
| List of contacts | hubspot__listObjects with a limit of 1 returned one result with its id, properties, createdAt, updatedAt, archived and url, plus a paging block with an after value. |
| Reads by ID | 4 hubspot__read calls on made-up IDs for a deal, a contact and a blog post (twice) all came back as status not_found. This does not show whether blog reads work on a portal. |
| Connector sign-in data, November 15 | The address answers HTTP 401 without a sign-in. Its discovery files list the scopes mcp:read and mcp:write, a registration endpoint, no metadata document support and PKCE with S256, which is Antigravity's third route, dynamic client registration. |
| Write and delete calls | None were run, so no change to a portal is claimed. |
Not run for this guide: anything inside Google Antigravity, any write or delete call, owner, property definition and list reads, and any existing blog post read. The IDE, the App and the CLI were not opened and no Ryze AI sign-in was completed from them, so the setup, sign-in and approval steps follow Google's Antigravity documentation as read on November 15, 2026.
Antigravity and HubSpot errors and fixes
Responses seen in the test calls
These responses came back from the test calls on November 14, 2026, through the Ryze AI connector. They are HubSpot or connector messages as returned, with IDs left out.
| Message or code | What it means | What to do |
|---|---|---|
| limit must be in range [0..200] (actual value: 201), Error 400, category VALIDATION_ERROR | The CRM search API returns at most 200 records per page. | Ask for 200 or fewer per page and page on with the after value. |
| There was a problem with the request. (Error 400) | HubSpot rejected the search body and did not say which property is wrong. The test used a filter on a property name that does not exist. | Read the property definitions first (crm/v3/properties/contacts) and use the internal property name. |
| The scope needed for this API call isn't available for public use. If you have questions, contact support or post in our developer forum. (status not_allowed) | The default Ryze AI connection could not search tickets on the test portal. | Use contacts, companies and deals through Ryze AI. For tickets use HubSpot's own connector or MCP server. |
| Object not found. objectId is usually positive. (status not_found) | No record has that ID. The test read a deal with ID 0. | Search for the record first and use the id it returns. |
| provider returned text/html;charset=iso-8859-1 (status 404) "Error 404 Not Found" (status not_found) | HubSpot answered with an HTML 404 page and the read tool, which parses JSON, reported it. It came back for a contact path and twice for a blog post path with made-up IDs. | Check the ID. Search for the contact by email, or list blog posts and use an ID from the list. |
Other problems
- The server never finishes connecting
- Antigravity waits up to 5 minutes for a server to connect. Check that mcp_config.json is valid JSON, that the entry uses serverUrl (or url) and not httpUrl, then reload the configuration.
- Authenticate does nothing in the App
- Finish the Ryze AI sign-in in the browser, copy the authorization code it shows, paste it into Enter authorization code and click Submit.
- The MCP Servers section is missing in the App
- The App is in the Knowledge Work layout. Open Settings > General > Interface Layout and choose Software Engineering.
- The HubSpot tools do not appear
- A tool list can be cached from before HubSpot was connected. Remove the ryze entry, add it again, then open a new chat. Check that the HubSpot card in Ryze AI shows Connected.
- HubSpot will not let you approve the app
- Installing needs a Super Admin or App Marketplace access. Ask a Super Admin to connect, or to approve and allow your user to install.
- A search finds nothing for a record you just made
- HubSpot says new or updated records can take a few moments to appear in search, and archived records never appear. Wait and search again.
- A property comes back empty or missing
- HubSpot returns a default subset of properties. Ask for the properties by their internal names.
- Another portal is needed
- A connection holds one portal. Click View on the HubSpot card, then Add one more account, and name the portal in your prompt.
- Blog post calls fail
- The content scope is available only on CMS Hub or Marketing Hub Professional or Enterprise accounts per HubSpot, and blog reads were not confirmed in the test.
- Every tool call asks for approval
- That is Antigravity's Ask mode for MCP tools without a rule. Allow chosen tools with the mcp(server/tool) form.
- The tools say a subscription is required
- The HubSpot tools need an active Ryze AI plan or free trial. Start the trial, then retry.
Terms on this page
- MCP
- The Model Context Protocol, an open standard through which an assistant such as Antigravity calls tools on outside servers.
- Portal
- A HubSpot account. Each Ryze AI connection to HubSpot is one portal.
- Scope
- A permission an app asks for at install time. Each one opens a set of HubSpot API endpoints and the data behind them.
- Super Admin and App Marketplace access
- The two HubSpot user permissions that allow installing an app. Everyone else needs a Super Admin.
- Filter group
- A block of filters in a CRM search. Filters inside a group are joined with AND, groups are joined with OR, and a search takes at most 5 groups of 6 filters.
- Recycling bin
- Where deleted CRM records go. HubSpot restores them for up to 90 days.
- Ask mode
- Antigravity's default for an MCP tool that has no rule: each call waits until you approve it.
Sources: scopes, working with OAuth, CRM search and restoring deleted records, checked November 14, 2026; Antigravity MCP documentation, checked November 15, 2026.
Frequently asked questions
How do I connect Antigravity to HubSpot?
Connect HubSpot in Ryze AI with its OAuth sign-in, then add a ryze entry with the serverUrl https://connector.get-ryze.ai/mcp to Antigravity's mcp_config.json and complete the Ryze AI sign-in.
Is there a HubSpot connector for Antigravity?
Yes, one is the Ryze AI connector at https://connector.get-ryze.ai/mcp, added as one serverUrl entry. HubSpot's own connectors are for ChatGPT, Claude, Gemini and Copilot, and its pages do not name Antigravity.
Is there a HubSpot MCP server for Antigravity?
HubSpot runs a remote MCP server at https://mcp.hubspot.com with 36 tools, but its pages do not name Antigravity and it needs a client ID and secret from an MCP connector you create in HubSpot. Whether it works with Antigravity's sign-in was not tested here.
What is a HubSpot MCP server?
A server that lets an AI client such as Antigravity call HubSpot tools over the Model Context Protocol. The Ryze AI one has 5 tools that list, search and read records, write them and delete them.
Where is the Antigravity MCP config file?
The global file is ~/.gemini/config/mcp_config.json and a workspace file is .agents/mcp_config.json. In the IDE, open the ... menu in the agent panel, then MCP Servers, Manage MCP Servers and View raw config.
Which Antigravity plan do I need for MCP?
No particular plan: Google's Antigravity MCP documentation names none. The setup is the same in the IDE, the App and the CLI, apart from how the sign-in starts.
Does Antigravity need a client ID for the Ryze AI connector?
No. Antigravity runs OAuth 2.0 with PKCE and registers itself with servers that support dynamic client registration, which the Ryze AI connector does. The HubSpot sign-in is separate and happens in Ryze AI.
Who can connect HubSpot to Ryze AI?
A HubSpot Super Admin or a user with App Marketplace access permissions. HubSpot requires one of the two to install any app.
Can Antigravity change my HubSpot records?
Yes. The write tool creates or updates contacts, companies and deals and adds associations between records. In Antigravity each call waits for your approval until you allow the tool, and no write call was run for this guide.
Can Antigravity delete things in HubSpot?
Yes, when you ask by ID. The delete tool archives a record, and most CRM deletes go to HubSpot's recycling bin, where records can be restored for up to 90 days. Deleted blog posts may not be recoverable.
Can I use several HubSpot portals?
Yes, one portal per connection and several connections in one Ryze AI workspace. One is the primary and is used unless you name another, and the tools accept an optional connection_id.
Does it reach HubSpot tickets or custom objects?
No. A ticket search through the connector returned status not_allowed on the test portal, and the requested scopes include no custom-object scope. Use contacts, companies and deals, or HubSpot's own connector for tickets.
Does the Antigravity CLI work with the connector?
The CLI reads the same mcp_config.json files, and /mcp opens the MCP Manager to check status and reload. Google lists no CLI sign-in steps, so this guide gives none, and the connector was not tested inside Antigravity.
How much does it cost?
Connecting costs nothing, but the tools need an active Ryze AI plan or free trial. Paid Ads is $89 per month with a 7-day free trial, SEO Starter is $129 per month with a 3-day free trial and Agency is $279 per month. Annual billing takes 30% off the first year.
How do I disconnect?
Delete the ryze entry from mcp_config.json, disconnect HubSpot on its card in Ryze AI, or uninstall the Ryze AI app inside HubSpot.