HubSpot Integration

The HubSpot integration provides access to manage HubSpot contacts, deals, and tickets through the Integrate MCP server.

Installation

The HubSpot integration is included with the SDK:

import { hubspotIntegration } from "integrate-sdk/server";

Setup

1. Create a HubSpot OAuth App

1. Go to HubSpot Developer Apps
2. Create a new OAuth application
3. Configure your redirect URI
4. Note your Client ID and Client Secret

2. Configure the Integration on Your Server

Add the HubSpot integration to your server configuration. The integration automatically reads HUBSPOT_CLIENT_ID and HUBSPOT_CLIENT_SECRET from your environment variables:

import { createMCPServer, hubspotIntegration } from "integrate-sdk/server";

export const { client: serverClient } = createMCPServer({
  apiKey: process.env.INTEGRATE_API_KEY,
  integrations: [
    hubspotIntegration({
    }),
  ],
});

You can override the environment variables by passing explicit values:

hubspotIntegration({
  clientId: process.env.CUSTOM_HUBSPOT_ID,
  clientSecret: process.env.CUSTOM_HUBSPOT_SECRET,
});

3. Client-Side Usage

The default client automatically includes all integrations. You can use it directly:

import { client } from "integrate-sdk";

await client.authorize("hubspot");
const result = await client.hubspot.listContacts({});

console.log(result);

If you're using a custom client, add the integration to the integrations array:

import { createMCPClient, hubspotIntegration } from "integrate-sdk";

const customClient = createMCPClient({
  integrations: [hubspotIntegration()],
});

Configuration Options

Tools

hubspot_list_contacts

List contacts

hubspot_get_contact

Get contact

hubspot_create_contact

Create contact

hubspot_update_contact

Update contact

hubspot_delete_contact

Delete contact

hubspot_list_companies

List companies

hubspot_get_company

Get company

hubspot_create_company

Create company

hubspot_update_company

Update company

hubspot_delete_company

Delete company

hubspot_list_deals

List deals

hubspot_get_deal

Get deal

hubspot_create_deal

Create deal

hubspot_update_deal

Update deal

hubspot_delete_deal

Delete deal

hubspot_list_tickets

List tickets

hubspot_get_ticket

Get ticket

hubspot_create_ticket

Create ticket

hubspot_update_ticket

Update ticket

hubspot_delete_ticket

Delete ticket

hubspot_search_crm

Search crm

hubspot_create_note

Create note

hubspot_create_task

Create task

hubspot_list_owners

List owners

hubspot_get_owner

Get owner

hubspot_list_pipelines

List pipelines

hubspot_list_pipeline_stages

List pipeline stages

hubspot_create_association

Create association

Notes

• Category: Business
• Authentication mode: OAuth