How to connect multiple HubSpot accounts to Claude

Connect multiple HubSpot accounts to Claude in 5 steps

Order matters: confirm access in HubSpot first, connect each portal, then add Claude.

Multi-portal setups at a glance

Pick the row that matches how your HubSpot portals relate to each other.

Rows 1 to 3 are Ryze AI and Claude settings that combine. Row 4 is HubSpot's own route.

How HubSpot handles several accounts on its side

A HubSpot login can open many portals, but each portal is its own account with its own users.

HubSpot's multi-account page says that to switch between accounts, your email address must already be added as a user on each HubSpot account you want to access. The feature is listed as available with all products and plans.

To switch, click your account name in the upper right, hover over the account name and Hub ID under Account, and pick another account. You can also open All accounts and choose Set as default for the account that opens at login.

Where to find the Hub ID

The Hub ID sits next to the account name in that menu. It is also the number in HubSpot URLs, as in app.hubspot.com/contacts/{HubID}/. It is the plainest way to tell two portals with similar names apart, so write it next to each portal in your notes.

What each connection reaches

In Ryze AI, a HubSpot connection is one portal. During sign-in you choose the portal and approve the requested permissions, so the connection reaches that portal only. To reach a second portal, you authorize it as another account.

How Ryze AI handles several HubSpot portals

Ryze AI keeps HubSpot portals as separate connections inside one workspace, and workspaces apart from each other.

The Ryze AI help center's rule is one workspace per business: several portals of the same brand share a workspace, and separate clients get their own. Every workspace keeps its own connections, team, settings and data, so client portals never mix.

Setting a new primary changes only the default. It does not disconnect anything, and you can still ask for any other portal by name. A new account or a changed primary applies from your next message.

On the Claude side, one connection covers up to 20 workspaces. To change the selection, remove the Ryze AI connector in Claude and add it again.

Which Ryze AI plan fits

Connecting the connector is free; the tools need an active plan or trial. Paid Ads costs $89 a month with a 7-day free trial, Agency costs $279 a month, and annual billing takes 30% off the first year. Check pricing for what each plan includes.

The 5 HubSpot tools Claude uses across portals

The same 5 tools serve every portal; the connection decides which portal answers.

Lists are read-only. The full tool page is HubSpot MCP server.

These tools accept an optional connection_id to pick a connection. Without it, the primary portal is used. In practice, you tell Claude which portal you mean and it handles the choice.

Name portals so Claude picks the right one

Most wrong-portal answers come from ambiguous names. Give Claude a fixed map once.

• Use the HubSpot account name and Hub ID together. Both appear in the account menu, so you can copy them exactly.
• Name the workspace after the client when you keep clients apart, so a prompt can name the workspace.
• Say which portal is primary. A request that names no portal goes to the primary one.
• Name the portal in every write request. The main risk with several CRMs is an edit landing in the wrong one.

Put the map in a Claude project

Claude projects carry instructions into every chat inside them. Paste this block once per agency or client:

6 prompts for working across HubSpot portals

Replace the brackets. Each prompt names its portal, so it works the same in a fresh chat.

Every answer comes from your own portals, so no example numbers are shown. Two portals can use different stage names and properties, so ask Claude to show both before it compares them.

If you build against HubSpot's own remote MCP server

HubSpot runs its own remote MCP server at https://mcp.hubspot.com, and it is set up per account.

• You create an MCP connector in HubSpot under Development > MCP Connectors, which generates OAuth credentials with a redirect URL you supply.
• PKCE is required. The sign-in flow has you select your HubSpot account, grant permissions based on user access levels and authorize.
• HubSpot's docs describe one authenticated connection per user session. They do not document connecting several accounts to one connector.
• HubSpot lists more than 30 tools, including search_crm_objects and manage_crm_objects.

The Ryze AI route needs no connector creation in HubSpot: you sign in, choose the portal and approve. It adds each further portal with Add one more account. Ryze AI's HubSpot tools are the 5 listed above.

Keep changes inside the right portal

With several CRMs in one chat, a write in the wrong portal is the main risk.

• In Claude, open Customize > Connectors > Ryze AI, and under Tool permissions set write and delete tools to Needs approval (Ryze AI help center).
• In the Ryze AI chat, Tool approvals starts on Skip all approvals. Switch it to Approve write & delete or Manual approve. Scheduled tasks run without an approval step.
• Delete only when you ask for it. Most CRM deletes go to HubSpot's recycling bin, but a deleted blog post may not be recoverable.
• Ask Claude to repeat the portal name and Hub ID before each change, as in prompt 6.

In Claude's Research mode, connector tools can run without further approval, so keep write work out of Research chats.

Troubleshooting: missing portals, wrong portal, stale tools

Match what you see to the row.

Causes come from the Ryze AI HubSpot help page and the Claude connector guide. For a single portal see how to connect Claude to HubSpot. The same ideas for ads accounts are in connecting multiple Google Ads accounts to Claude. All setups: Ryze AI integrations.

Sources

The verdict

Get added as a user on every HubSpot portal, authorize each one in Ryze AI with Add one more account and add the connector to Claude once. Then name the portal in every prompt and set write and delete tools to Needs approval.