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
- In HubSpot’s main navigation on the far left, click More → Development.
- In the Development sidebar, select MCP Connectors.
- Click Create MCP connector.
- 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.
- Click Create.
Step 2: Copy your credentials
- On the connector’s details page, copy the Client ID and Client Secret.
- 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
- Click Add server.
- Click Connect on the HubSpot server.
- Select the intended HubSpot account in the authorization flow.
- 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.
- Return to Conversion and confirm the server shows Authorized.
Test the connection
- Open the server’s Tools tab and confirm tools are listed.
- 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.” - Approve the read-only tool call if prompted.
- Confirm the tool succeeds and reports the intended HubSpot account.
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.