Create a HubSpot MCP auth app for OpenConnector

OpenConnector’s current HubSpot provider uses HubSpot’s remote MCP OAuth flow. Create an MCP auth app in HubSpot, copy its client ID and client secret, then save those values for the hubspot service in OpenConnector.

OpenConnector service

Service ID	Provider	Auth type
`hubspot`	HubSpot remote MCP server	OAuth2 with PKCE

The HubSpot provider connects through https://mcp.hubspot.com. HubSpot’s MCP auth app controls the HubSpot-side permissions and account authorization flow.

Prerequisites

A running OpenConnector runtime.
A HubSpot account with access to the Developer Platform and MCP Auth Apps.
Permission to create an MCP auth app for the HubSpot account you want to connect.
The OpenConnector origin users open in the browser, such as http://localhost:3000 or https://connect.example.com.

Step 1: Set the OpenConnector callback URL

Build the callback URL by appending /oauth/callback to your OpenConnector origin. For local testing, use http://localhost:3000/oauth/callback. For a public deployment, set OOMOL_CONNECT_ORIGIN, restart OpenConnector, and use the public callback URL, such as https://connect.example.com/oauth/callback.

Step 2: Create a HubSpot MCP auth app

In HubSpot:

Open the HubSpot account you want to connect.
Open Development.
Open MCP Auth Apps.
Create a new MCP auth app.
Enter a recognizable app name.
Set the redirect URL to the exact OpenConnector callback URL.
Save the app.

HubSpot’s official guide is Integrate AI tools with the HubSpot MCP server.

Step 3: Copy the client credentials

From the HubSpot MCP auth app details, copy:

HubSpot value	OpenConnector field
Client ID	`clientId`
Client Secret	`clientSecret`

Step 4: Save the HubSpot client in OpenConnector

Use the OpenConnector web console:

Open the OpenConnector web console, such as http://localhost:3000.
Open Providers and select HubSpot.
Choose Configure OAuth Client or Edit OAuth Client.
Paste the HubSpot client ID and client secret.
Choose Save OAuth Client.

Step 5: Connect and test

After saving the OAuth client, choose Connect on the HubSpot provider page. Select the HubSpot account, approve access, return to OpenConnector, and confirm that the provider page shows the account as connected.

Use the console action details before running CRM actions such as hubspot.list_properties.

Troubleshooting

Symptom	What to check
HubSpot says the client ID is invalid	Confirm you copied the Client ID from the MCP auth app, not from a different HubSpot app type.
Redirect or callback fails	The redirect URL in HubSpot must exactly match `<openconnector-origin>/oauth/callback`.
Token exchange fails	Confirm the HubSpot MCP auth app supports OAuth with PKCE and that OpenConnector is using the current HubSpot provider.
HubSpot account selection is wrong	Sign out of extra HubSpot accounts in the browser, or use a separate browser profile for authorization.
Actions return permission errors	Check the connected HubSpot user’s permissions and the HubSpot MCP app’s current access rules.