---
title: "HubSpot Integration"
description: "Manage HubSpot contacts, deals, and tickets"
---
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:

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

## Setup

### 1. Create a HubSpot OAuth App

1. Go to [HubSpot Developer Apps](https://app.hubspot.com/developers)
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:

```typescript
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:

```typescript
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:

```typescript
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:

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

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

## Configuration Options

<AutoTypeTable
  path="../src/integrations/hubspot.ts"
  name="HubSpotIntegrationConfig"
/>


## Tools

### `hubspot_list_contacts`

List contacts

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotListContactsParams"
/>

### `hubspot_get_contact`

Get contact

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotGetContactParams"
/>

### `hubspot_create_contact`

Create contact

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotCreateContactParams"
/>

### `hubspot_update_contact`

Update contact

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotUpdateContactParams"
/>

### `hubspot_delete_contact`

Delete contact

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotDeleteContactParams"
/>

### `hubspot_list_companies`

List companies

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotListCompaniesParams"
/>

### `hubspot_get_company`

Get company

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotGetCompanyParams"
/>

### `hubspot_create_company`

Create company

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotCreateCompanyParams"
/>

### `hubspot_update_company`

Update company

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotUpdateCompanyParams"
/>

### `hubspot_delete_company`

Delete company

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotDeleteCompanyParams"
/>

### `hubspot_list_deals`

List deals

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotListDealsParams"
/>

### `hubspot_get_deal`

Get deal

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotGetDealParams"
/>

### `hubspot_create_deal`

Create deal

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotCreateDealParams"
/>

### `hubspot_update_deal`

Update deal

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotUpdateDealParams"
/>

### `hubspot_delete_deal`

Delete deal

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotDeleteDealParams"
/>

### `hubspot_list_tickets`

List tickets

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotListTicketsParams"
/>

### `hubspot_get_ticket`

Get ticket

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotGetTicketParams"
/>

### `hubspot_create_ticket`

Create ticket

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotCreateTicketParams"
/>

### `hubspot_update_ticket`

Update ticket

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotUpdateTicketParams"
/>

### `hubspot_delete_ticket`

Delete ticket

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotDeleteTicketParams"
/>

### `hubspot_search_crm`

Search crm

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotSearchCrmParams"
/>

### `hubspot_create_note`

Create note

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotCreateNoteParams"
/>

### `hubspot_create_task`

Create task

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotCreateTaskParams"
/>

### `hubspot_list_owners`

List owners

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotListOwnersParams"
/>

### `hubspot_get_owner`

Get owner

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotGetOwnerParams"
/>

### `hubspot_list_pipelines`

List pipelines

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotListPipelinesParams"
/>

### `hubspot_list_pipeline_stages`

List pipeline stages

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotListPipelineStagesParams"
/>

### `hubspot_create_association`

Create association

<AutoTypeTable
  path="generated/tool-params/hubspot.ts"
  name="HubspotCreateAssociationParams"
/>

## Notes

- Category: Business
- Authentication mode: OAuth