About HubSpot
HubSpot is an MCP server published by baryhuang in the Developer Tools category: 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.
The repository has 130 stars and 63 forks, with the last commit 11 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/baryhuang/mcp-hubspotThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (7)
hubspot_create_companyCreate companies with duplicate prevention
Parameters not published.
hubspot_create_contactCreate contacts with duplicate prevention
Parameters not published.
hubspot_get_active_companiesRetrieve most recently active companies
Parameters not published.
hubspot_get_active_contactsRetrieve most recently active contacts
Parameters not published.
hubspot_get_company_activityRetrieve activity for specific companies
Parameters not published.
hubspot_get_recent_conversationsRetrieve recent conversation threads with messages
Parameters not published.
hubspot_search_dataSemantic search across previously retrieved HubSpot data
Parameters not published.
Ask AI
Ask AI about HubSpot
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 1 hours ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
HubSpot MCP Server
Overview
A Model Context Protocol (MCP) server that enables AI assistants to interact with HubSpot CRM data. This server bridges AI models with your HubSpot account, providing direct access to contacts, companies, and engagement data. Built-in vector storage and caching mechanisms help overcome HubSpot API limitations while improving response times.
Our implementation prioritizes the most frequently used, high-value HubSpot operations with robust error handling and API stability. Each component is optimized for AI-friendly interactions, ensuring reliable performance even during complex, multi-step CRM workflows.
Why MCP-HubSpot?
- Direct CRM Access: Connect Claude and other AI assistants to your HubSpot data without intermediary steps
- Context Retention: Vector storage with FAISS enables semantic search across previous interactions
- Zero Configuration: Simple Docker deployment with minimal setup
Example Prompts
Create HubSpot contacts and companies from this LinkedIn profile:
[Paste LinkedIn profile text]
What's happening lately with my pipeline?
Available Tools
The server offers tools for HubSpot management and data retrieval:
| Tool | Purpose |
|---|---|
hubspot_create_contact |
Create contacts with duplicate prevention |
hubspot_create_company |
Create companies with duplicate prevention |
hubspot_get_company_activity |
Retrieve activity for specific companies |
hubspot_get_active_companies |
Retrieve most recently active companies |
hubspot_get_active_contacts |
Retrieve most recently active contacts |
hubspot_get_recent_conversations |
Retrieve recent conversation threads with messages |
hubspot_search_data |
Semantic search across previously retrieved HubSpot data |
Performance Features
- Vector Storage: Utilizes FAISS for efficient semantic search and retrieval
- Thread-Level Indexing: Stores each conversation thread individually for precise retrieval
- Embedding Caching: Uses SentenceTransformer with automatic caching
- Persistent Storage: Data persists between sessions in configurable storage directory
- Multi-platform Support: Optimized Docker images for various architectures
Setup
Prerequisites
You'll need a HubSpot access token with these scopes:
- crm.objects.contacts (read/write)
- crm.objects.companies (read/write)
- sales-email-read
Quick Start
# Install via Smithery (recommended)
npx -y @smithery/cli@latest install mcp-hubspot --client claude
# Or pull Docker image directly
docker run -e HUBSPOT_ACCESS_TOKEN=your_token buryhuang/mcp-hubspot:latest
Docker Configuration
For manual configuration in Claude desktop:
{
"mcpServers": {
"hubspot": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "HUBSPOT_ACCESS_TOKEN=your_token",
"-v", "/path/to/storage:/storage", # Optional persistent storage
"buryhuang/mcp-hubspot:latest"
]
}
}
}
Building Docker Image
To build the Docker image locally:
git clone https://github.com/buryhuang/mcp-hubspot.git
cd mcp-hubspot
docker build -t mcp-hubspot .
For multi-platform builds:
docker buildx create --use
docker buildx build --platform linux/amd64,linux/arm64 -t buryhuang/mcp-hubspot:latest --push .
Development
pip install -e .
License
MIT License
README fetched from the repository 1 hours ago. The original is authoritative.