HubSpot MCP Server
@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.
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
7Create 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.
Frequently asked questions
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.
Basic information
More Data & Analytics MCP servers
Subtext
Subtext by FullstorySession replay, built for agents. Subtext is agentic session review: it captures production sessions of your app and connects them to your coding agent — Claude Code, Cursor, Codex, Devin, your own harness — so it can
Sugra API MCP
Sugra Systems, Inc.Official MCP server for the Sugra API, giving AI agents source-attributed access to 1,500+ endpoints across 36 data domains from 160+ primary sources. Covers markets, economics, company fundamentals, government, news, cl
mcp-simple-arxiv
andybrandtTool to work with arXiv, provide LLM with ability to search and read papers from there
Linkly Link Shortener
LinklyLinkly is an URL shortener with geo redirects, click & conversion tracking, link rotators, mobile deep links and an URL shortening API.
Rankbits
rankbitsAI visibility analytics across 15+ providers (ChatGPT, Perplexity, Gemini, AI Overviews, and more). The MCP connector lets assistants run scans, compare competitor mentions, and track your brand's visibility in AI answer
Comments