Skip to content
Platform Status

HubSpot

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 Auth Apps 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 Auth Apps.

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

Create the MCP auth app

  1. In the upper right, click Create MCP auth app.
  2. In App name, enter a recognizable name, such as Speakeasy AI Control Plane.
  3. Optionally, enter a Description.
  4. In Redirect URL, paste https://app.getgram.ai/mcp/remote_login_callback.
  5. Optionally, add an Icon.
  6. Click Create.

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

Copy the client credentials

HubSpot opens the app’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 Connect, select Sources.
  2. Click Add Source.
  3. Choose 3rd-party server.
  4. On the MCP Catalog page, use Search MCP servers… to find HubSpot.
  5. Open the HubSpot entry with View.
  6. Click Add.
  7. In the Add to Project dialog, click Add to Project.

This creates the hosted MCP server and opens its Overview page.

Connect your credentials

  1. From the server’s Overview, open Settings.
  2. Under Authentication, click Configure Manually, or click Use Discovered if it is available.
  3. In Attach Remote Identity Provider, set Client Type to Manual.
  4. Confirm that Redirect URI matches the https://app.getgram.ai/mcp/remote_login_callback value registered in HubSpot’s Redirect URL field.
  5. Paste the Client ID copied in Copy the client credentials.
  6. Paste the Client Secret (optional) copied in Copy the client credentials.
  7. Leave any scope override empty.
  8. Click Attach Identity Provider.

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 at https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server.