Skip to content
Status

HubSpot

Connect HubSpot's hosted MCP server using an MCP connector and OAuth.

You need a HubSpot account and a user who can open the Development workspace from the main navigation bar. The remote MCP server is available to all HubSpot accounts. Sign in at app.hubspot.com.

Open MCP Connectors in the Development workspace

  1. Sign in at app.hubspot.com.
  2. In the main navigation bar, select Development.
  3. In the left sidebar menu, select MCP Connectors.

If Development is unavailable, use the direct MCP Connectors page. If you still cannot open it, ask your HubSpot administrator to confirm your access to this developer feature.

Create the MCP connector

  1. In the upper right, click Create MCP connector.

  2. In Name, enter a recognizable name, such as Speakeasy AI Control Plane.

  3. Optionally, enter a Description.

  4. In Redirect URL, paste this value:

    https://ai.speakeasy.com/mcp/remote_login_callback

  5. Optionally, add an Icon.

  6. Click Create.

If you configure multiple redirect URLs, keep https://ai.speakeasy.com/mcp/remote_login_callback first because HubSpot uses the first URL as the default.

Copy the client credentials

HubSpot opens the connector’s details page.

  1. Copy the Client ID.
  2. Copy the Client secret.

Treat the Client secret like a password. Both values remain available on this page. Continue to Connect your credentials.

Add the server in Speakeasy

  1. In the Speakeasy AI Control Plane sidebar, under MCP Gateway, select MCP.
  2. Click Add new to open the Add MCP server page.
  3. Choose From the catalog.
  4. On the MCP Catalog page, use Search MCP servers… to find HubSpot.
  5. Open the HubSpot entry.
  6. Click Add.
  7. In the Add to Project dialog, under Identity, select User Identity. The dialog preselects No Identity for HubSpot.
  8. Click Add to Project. If the dialog offers a Guardrails step, click Skip for now.
  9. When the dialog finishes, the result reads “Added, but disabled until identity is set up.” Click Finish setup to open the server’s Settings.

HubSpot needs a client registered by hand, so the server is kept Disabled and the result says to finish setup in Settings > Identity. This is expected.

Connect your credentials

Open the server’s Settings and find the Identity section.

  1. Select User Identity.
  2. Under Choose an identity provider, confirm the preselected provider is https://mcp.hubspot.com. A provider that does not exist yet shows Will be created.
  3. Select Manual. It is the default for HubSpot unless the provider already has a client.
  4. In Client ID, paste the Client ID copied in Copy the client credentials.
  5. In Client secret, paste the Client secret copied in Copy the client credentials. HubSpot requires it, even though the field shows “Optional”.
  6. Leave Advanced > Scope blank. HubSpot determines scopes automatically and advertises none, so a blank field requests nothing extra.
  7. Click Save.
  8. Open Settings > Danger Zone > Server Availability and turn on Enable MCP server so it shows Enabled.

This screen does not show the redirect URI. If authorization later fails with a redirect error, check that the connector’s Redirect URL in HubSpot is https://ai.speakeasy.com/mcp/remote_login_callback, as set in Create the MCP connector.

For the HubSpot account’s first connection, use an account admin. HubSpot does not document which admin role qualifies.

  1. When HubSpot authorization opens, select the intended account.
  2. Grant the permissions offered.
  3. Authorize the connection.

This guide covers setup only. For anything beyond it — billing, tool behavior, limits — see HubSpot’s MCP documentation.