HubSpot

Connect your company's HubSpot account to Cakewalk so agents can search contacts, read deals, update properties and work with engagements through the gateway.

Connect your company's HubSpot account to Cakewalk's MCP Gateway. Every agent tool call against HubSpot passes through the gateway and is evaluated against your Policies.

Requirements

• HubSpot user with access to the Developer area of your company's HubSpot account.

About Scopes

HubSpot surfaces required scopes on the OAuth consent screen at connect time. You will approve the scope set in the HubSpot consent flow; nothing is preselected on the MCP auth app configuration page. The scope set requested by mcp.hubspot.com determines which agent actions are available against HubSpot once the Connection is live.

Step 1: Create an MCP Auth App in HubSpot

1. Sign in to your company's HubSpot account.

2. In the left sidebar, open Development.

3. Click MCP Auth Apps.

4. In the upper right, click Create MCP auth app.

5. Enter a name for the app, then create it.

You land on the app's configuration page.

Step 2: Configure the Redirect URL

1. On the app's configuration page, find the Redirect URL field.

2. Paste this URL:

https://mcp-gateway.getcakewalk.io/api/v1/Auth/Callback

1. Save.

Step 3: Generate PKCE Values

OAuth 2.1 installs require PKCE, so HubSpot will not let you test or run the install URL until you generate PKCE values.

1. On the app's configuration page, find the Installation URL Builder (OAuth 2.1) section.

2. Click Generate PKCE values.

3. HubSpot generates one time PKCE values for the install. They are not saved, so generate them here as part of setup.

The Test URL button stays disabled until PKCE values exist.

Step 4: Copy the Client ID and Client Secret

The MCP auth app's configuration page shows the Client ID and Client Secret. Copy both. HubSpot may hide the secret after first view; copy it now.

Step 5: Paste Credentials Into Cakewalk

1. Open https://app.getcakewalk.io.

2. Go to All Connections.

3. Find HubSpot.

4. Click Edit credentials.

5. Paste the Client ID and Client Secret.

6. Save.

Verifying It Works

The HubSpot Connection card flips to Active on All Connections. From an agent platform connected to Cakewalk, ask the agent to look up a contact in HubSpot by email. If HubSpot returns the contact, the Connection is live.

Troubleshooting

• Invalid redirect URI on consent: the value in Redirect URL must match https://mcp-gateway.getcakewalk.io/api/v1/Auth/Callback exactly, with no trailing slash.

• Dynamic client registration is required but not supported: HubSpot removed dynamic client registration from mcp.hubspot.com in mid 2026. The customer self serve path documented on this page replaces it. If you previously connected via the older dynamic flow, recreate the Connection using these steps.

• Lost Client Secret: if you missed the initial copy, regenerate the secret on the MCP auth app's configuration page and re paste it in Cakewalk.

Learn More

• HubSpot OAuth quickstart