Skip to main content
Create an MCP connector in HubSpot, then add it to Conversion so AI chats and agents can use your HubSpot account.

Set up HubSpot

Before you begin

  • A Conversion Administrator account to add the server.
  • Access to create an MCP connector in the HubSpot account you want to connect.
  • A HubSpot super admin who can approve the connector if your account requires approval.

Step 1: Create an MCP connector

  1. In HubSpot’s main navigation on the far left, click More → Development.
  2. In the Development sidebar, select MCP Connectors.
  3. Click Create MCP connector.
  4. Enter the following details:
    • Name: Conversion
    • Description (optional): HubSpot integration for Conversion
    • Redirect URL: https://agentapi.conversion.ai/api/v1/mcp/oauth/callback
    • Icon (optional): Upload an icon if you’d like one.
  5. Click Create.

Step 2: Copy your credentials

  1. On the connector’s details page, copy the Client ID and Client Secret.
  2. Store both securely for the Conversion setup below. If your Conversion team is setting up the server for you, share the credentials securely with them.

Step 3: Add the server in Conversion

In Conversion, go to Settings → AI → Connections. Under MCP servers, click Add MCP server (or Add server below an existing list). Fill in the fields below.
The Server URL is HubSpot’s MCP endpoint. The Redirect URL from Step 1 is where HubSpot returns you after authorization; do not paste it into Server URL.

Step 4: Authorize the connection

  1. Click Add server.
  2. Click Connect on the HubSpot server.
  3. Select the intended HubSpot account in the authorization flow.
  4. Review the requested access and authorize the connector. If HubSpot asks you to request approval, have a super admin approve it before completing the connection.
  5. Return to Conversion and confirm the server shows Authorized.
Each member who uses this OAuth server must click Connect for their own account. Adding the server does not authorize everyone.

Test the connection

  1. Open the server’s Tools tab and confirm tools are listed.
  2. Start a Conversion AI chat and ask: “Use the HubSpot MCP to check my connected account and available object types with get_user_details. Do not change any data.”
  3. Approve the read-only tool call if prompted.
  4. Confirm the tool succeeds and reports the intended HubSpot account.
Tool availability depends on your HubSpot permissions and account configuration. A successful connection does not guarantee that every object, including forms, is accessible. See HubSpot’s MCP documentation. Review tool approval settings before using tools that change data.

Troubleshooting

  • Not Found or Unreachable: check that the server URL is https://mcp.hubspot.com.
  • Not authorized or Connect to view tools: complete your own connection, including any HubSpot approval request.
  • Redirect mismatch: confirm the HubSpot connector has the exact redirect URL from Step 1.
After correcting the settings, reconnect if needed and use Refresh tools on the server page. A tools list confirms discovery; a successful read-only call confirms access to the platform.