Skip to main content

Set up the HubSpot MCP server

HubSpot's MCP server gives AI agents read access to CRM data — contacts, companies, deals, tickets, invoices, quotes, and more. This guide covers creating a HubSpot MCP auth app, obtaining OAuth credentials, and connecting the server to MintMCP.

Prerequisites​

  • A MintMCP admin account
  • A HubSpot account with access to the Development section

Create an MCP auth app in HubSpot​

  1. In your HubSpot account, navigate to Development in the left sidebar.

  2. Click MCP Auth Apps.

  3. Click Create MCP auth app in the upper right.

  4. Enter an app name (for example, "MintMCP").

  5. In the Redirect URL field, enter:

    https://app.mintmcp.com/oauth/callback

  6. Click Create.

HubSpot creates the app and takes you to the app details page.

Copy the client ID and secret​

  1. On the app details page, copy the Client ID.
  2. Copy the Client Secret. You'll need both in the next step.

Keep the client secret secure — anyone with it can make OAuth requests on behalf of your app.

Add HubSpot to MintMCP​

  1. In MintMCP, go to MCP store.

  2. Click + Add an MCP to your registry → Connect to an MCP by URL.

  3. Enter the server URL:

    https://mcp.hubspot.com

  4. Set Connection type to Per-user credentials.

  5. Set Authorization method to OAuth.

  6. Open OAuth Client Advanced Settings and paste the Client ID and Client Secret from your HubSpot MCP auth app.

  7. Click Create.

Security considerations​

  • The client secret grants OAuth access to HubSpot CRM data — keep it out of version control and restrict who can view it in MintMCP.
  • Each user authenticates individually through OAuth, so tool calls are attributed to their HubSpot identity and limited by their existing HubSpot permissions.
  • HubSpot determines available scopes automatically from the tools in the MCP server and each user's permissions — no explicit scope configuration is needed.
  • The server provides read-only access to CRM data; it does not support creating or modifying records.

Next steps​