---
title: Create a HubSpot MCP auth app for OpenConnector
description: Create a HubSpot MCP auth app, configure the OpenConnector redirect
  URL, and connect HubSpot through OAuth.
lang: en
canonical_url: https://oomol.com/en/docs/openconnector-hubspot-oauth-app/
markdown_url: https://oomol.com/en/docs/openconnector-hubspot-oauth-app.md
---

# 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:

1. Open the HubSpot account you want to connect.
2. Open **Development**.
3. Open **MCP Auth Apps**.
4. Create a new MCP auth app.
5. Enter a recognizable app name.
6. Set the redirect URL to the exact OpenConnector callback URL.
7. Save the app.

HubSpot's official guide is [Integrate AI tools with the HubSpot MCP server](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-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:

1. Open the OpenConnector web console, such as `http://localhost:3000`.
2. Open **Providers** and select **HubSpot**.
3. Choose **Configure OAuth Client** or **Edit OAuth Client**.
4. Paste the HubSpot client ID and client secret.
5. 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. |