home / mcp / hubspot mcp server

HubSpot MCP Server

Provides HubSpot data access and actions via MCP for contacts, companies, and engagements.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "sheffieldp-hubspot_mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "buryhuang/mcp-hubspot:latest"
      ]
    }
  }
}

You can connect AI models to HubSpot data and operations through a dedicated MCP server that exposes HubSpot resources and tools. This enables you to read and manage contacts, companies, and recent engagements from HubSpot within your MCP-enabled workflows and AI prompts.

How to use

Start the HubSpot MCP Server container and then interact with its resources and tools from your MCP client. Use the hubspot server to retrieve contacts and companies, create new records with duplicate checks, and fetch recent engagements for insight and action.

How to install

Prerequisites you need before starting are Docker and access to the HubSpot API as described in the setup notes.

docker pull buryhuang/mcp-hubspot:latest
```

```
docker run -i -
  buryhuang/mcp-hubspot:latest

Available tools

hubspot_get_contacts

Retrieve contacts from HubSpot. No input required. Returns: Array of contact objects.

hubspot_create_contact

Create a new contact in HubSpot with duplicate checks. Requires firstname and lastname; optional email and properties. Returns existing contact if a match is found, or the new contact details if created.

hubspot_get_companies

Retrieve companies from HubSpot. No input required. Returns: Array of company objects.

hubspot_create_company

Create a new company in HubSpot with duplicate checks. Requires name; optional properties. Returns existing company if a match is found, or the new company details if created.

hubspot_get_company_activity

Get activity history for a specific HubSpot company using company_id. Returns: Array of activity objects.

hubspot_get_recent_engagements

Get HubSpot engagements from the last 3 days across all companies and contacts. Returns: Array of engagement objects with full metadata.