HubSpot MCP Server

@peakmojo

Basic information

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 #semantic-search#faiss#faiss-vector-database#mcp-server

HubSpot MCP Server config

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

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

HubSpot MCP Server 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?

A Model Context Protocol (MCP) server that connects AI assistants directly to HubSpot CRM data, enabling interaction with contacts, companies, and engagement records. Built-in FAISS vector storage and caching improve response times and overcome HubSpot API limitations.

How to use HubSpot MCP Server?

Install via Smithery (npx -y @smithery/cli@latest install mcp-hubspot --client claude) or run the Docker image with a HubSpot access token. For Claude desktop, configure the server in mcpServers using the provided Docker command. The token must have scopes for contacts, companies, and sales-email-read.

Key features of HubSpot MCP Server

Create contacts and companies with duplicate prevention
Retrieve recent company activity and conversations
Semantic search across retrieved HubSpot data
FAISS vector storage for efficient retrieval
Thread-level indexing with embedding caching
Persistent storage between sessions

Use cases of HubSpot MCP Server

Create HubSpot contacts and companies from a LinkedIn profile
Monitor recent pipeline activity and conversation threads
Automate CRM data entry without manual steps
Query and summarize HubSpot engagement data via AI
Enable AI assistants to manage HubSpot workflows

Frequently asked questions

What HubSpot scopes does the access token need?

The token requires crm.objects.contacts (read/write), crm.objects.companies (read/write), and sales-email-read.

How do I install HubSpot MCP Server?

You can install via Smithery using npx, or pull the Docker image directly with `docker run -e HUBSPOT_ACCESS_TOKEN=your_token buryhuang/mcp-hubspot:latest`.

Where does persistent storage data live?

Data persists between sessions in a configurable storage directory. When running Docker, mount a host volume using `-v /path/to/storage:/storage`.

How is data retrieved from HubSpot?

The server provides dedicated tools (e.g., `hubspot_get_active_companies`, `hubspot_get_recent_conversations`) and a semantic search tool (`hubspot_search_data`) that uses FAISS vector storage.

What transport or authentication does the server use?

Authentication uses a HubSpot access token passed via the `HUBSPOT_ACCESS_TOKEN` environment variable. The server communicates over stdio when run via Docker CLI.

Comments

More Data & Analytics MCP servers

Aayat AI

Pay-per-use data and tools for AI agents: crypto token safety and rug checks, web search with cited answers, page-to-Markdown, up-to-date library docs, package safety, company research and UK/EU open data. 160 tools, 20

Waqi - AI Privacy Layer

ajprolific

Waqi — hosted MCP server that redacts PII from your business tools before the AI sees them. Audit log included.

CoinLobster

The only MCP server with live whale trades across 15 exchanges plus on-chain DEX flow. Smart Money Radar, real liquidations and outcome-scored signals. No API key required.

Localith MCP

Localith MCP connects Claude and ChatGPT to your Google Business Profile data. Retrieve connected locations, listing details, customer reviews, and performance metrics to analyze review trends, compare locations, audit l

iubenda

Connect your AI assistant to iubenda's privacy policy generator, terms and conditions generator, and cookie banner. Generate a privacy policy, cookie policy, and terms and conditions for your website or app, then set up