HubSpot MCP Server

@peakmojo

代码仓库

基本信息

分类

数据与分析

许可证

MIT

传输方式

stdio

作者

peakmojo

关于 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 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

HubSpot MCP Server 工具

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

概览

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

常见问题

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.

数据与分析分类下的更多 MCP 服务器

SocialAPIs — Facebook & Instagram Data

SocialAPIsHub

Facebook & Instagram data for AI agents — pages, posts, groups, Ads Library, Marketplace, profiles and reels. 47 read-only tools with structured output.

YouTube MCP Server

HasData

Hosted YouTube MCP server for search, video metadata, channel data and timestamped transcripts. Connect Claude, Cursor or other MCP clients with HasData; no YouTube API key required.

looot

One key and one balance for 2,350 data APIs from 76 providers your AI agent can call: email finding, enrichment, SEO, scraping, social data. Pay per call, price shown before every run.

Forency

cheevahagadog

Investigate any website's technology stack: CMS, eCommerce, frameworks, analytics, CRM, payments, and hosting behind any URL. Ask "which of these 15 prospects use HubSpot vs Salesforce?" and get a table back. Free tier:

Midpoint Card Prices

I Lov Guitars Inc.

Trading-card market prices and grading ROI as MCP tools. Read-only, no auth. Powers the Midpoint Card Prices plugin in ChatGPT; works with Claude, Cursor and any MCP client.