HubSpot MCP Server

Name: HubSpot MCP Server
Author: baryhuang

@baryhuang

About HubSpot MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to interact with HubSpot CRM data, providing built-in vector storage and caching mechanisms help overcome HubSpot API limitations while improving response times.

#crm #hubspot #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-hubspot": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "install",
        "mcp-hubspot",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

Create contacts with duplicate prevention

Create companies with duplicate prevention

Retrieve activity for specific companies

Retrieve most recently active companies

Retrieve most recently active contacts

Retrieve recent conversation threads with messages

Semantic search across previously retrieved HubSpot data

Overview

What is HubSpot MCP Server?

An MCP server that connects AI assistants (like Claude) to HubSpot CRM data. It provides tools for managing contacts, companies, and engagement records, with built-in vector storage (FAISS) and caching to overcome HubSpot API limits and improve response times.

How to use HubSpot MCP Server?

Install via Smithery (npx -y @smithery/cli@latest install mcp-hubspot --client claude) or pull the Docker image (docker run -e HUBSPOT_ACCESS_TOKEN=your_token buryhuang/mcp-hubspot:latest). Configure the Docker container in your MCP client (e.g., Claude Desktop) with the HUBSPOT_ACCESS_TOKEN environment variable and an optional volume for persistent storage.

Key features of HubSpot MCP Server

Vector storage using FAISS for semantic search across HubSpot data
Thread-level indexing for precise retrieval of conversation records
Embedding caching with SentenceTransformer for faster responses
Persistent storage in a configurable directory between sessions
Duplicate prevention when creating contacts and companies
Multi-platform Docker images (linux/amd64, linux/arm64)

Use cases of HubSpot MCP Server

Create HubSpot contacts and companies from a LinkedIn profile paste
Retrieve recent pipeline activity and engagement updates
Semantic search over previously fetched CRM data for context-aware queries

FAQ from HubSpot MCP Server

What tools does HubSpot MCP Server provide?

It provides seven tools: hubspot_create_contact, hubspot_create_company, hubspot_get_company_activity, hubspot_get_active_companies, hubspot_get_active_contacts, hubspot_get_recent_conversations, and hubspot_search_data.

What HubSpot permissions are required?

A HubSpot access token with scopes crm.objects.contacts (read/write), crm.objects.companies (read/write), and sales-email-read.

How do I deploy HubSpot MCP Server?

You can use Docker directly with docker run or install via Smitherly. For manual setup, run the Docker container and pass the token via HUBSPOT_ACCESS_TOKEN. Optionally mount a volume at /storage for persistent data.

Does HubSpot MCP Server store data locally?

Yes, it stores conversation threads and embeddings in a configurable storage directory (/storage by default). Data persists between sessions when the volume is mounted.

What is the vector storage used for?

The FAISS vector store enables semantic search across previously retrieved HubSpot data, allowing AI assistants to recall past CRM interactions without re-fetching from the API.

Comments

More Data & Analytics MCP servers

Salesforce MCP Server

tsmztech

Salesforce MCP Server

161

Healthcare MCP Server

Cicatriiz

A Model Context Protocol (MCP) server providing AI assistants with access to healthcare data and medical information tools, including FDA drug info, PubMed, medRxiv, NCBI Bookshelf, clinical trials, ICD-10, DICOM metadata, and a medical calculator.

117