HubSpot MCP Server
허브스팟 MCP 서버
개요
AI 어시스턴트가 HubSpot CRM 데이터와 상호 작용할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 AI 모델을 HubSpot 계정과 연결하여 연락처, 회사 및 참여 데이터에 직접 액세스할 수 있도록 합니다. 내장된 벡터 스토리지 및 캐싱 메커니즘은 HubSpot API의 한계를 극복하고 응답 시간을 단축하는 데 도움이 됩니다.
저희 구현 방식은 가장 자주 사용되고 가치가 높은 HubSpot 작업을 우선시하며, 강력한 오류 처리 및 API 안정성을 제공합니다. 각 구성 요소는 AI 친화적인 상호작용에 최적화되어 있어 복잡하고 여러 단계로 구성된 CRM 워크플로에서도 안정적인 성능을 보장합니다.
Related MCP server: HubSpot MCP Server
왜 MCP-HubSpot인가요?
직접 CRM 액세스 : 중간 단계 없이 Claude 및 기타 AI 도우미를 HubSpot 데이터에 연결합니다.
컨텍스트 유지 : FAISS를 사용한 벡터 저장을 통해 이전 상호 작용에 대한 의미 검색이 가능해집니다.
제로 구성 : 최소한의 설정으로 간단한 Docker 배포
예시 프롬프트
지엑스피1
What's happening lately with my pipeline?사용 가능한 도구
이 서버는 HubSpot 관리 및 데이터 검색을 위한 도구를 제공합니다.
도구 | 목적 |
| 중복 방지를 통해 연락처 생성 |
| 중복 방지를 통해 기업을 만들어 보세요 |
| 특정 회사의 활동 검색 |
| 가장 최근에 활동한 회사 검색 |
| 가장 최근에 활동한 연락처 검색 |
| 메시지가 포함된 최근 대화 스레드 검색 |
| 이전에 검색된 HubSpot 데이터에 대한 의미 검색 |
성능 특징
벡터 스토리지 : 효율적인 의미 검색 및 검색을 위해 FAISS 활용
스레드 수준 인덱싱 : 정확한 검색을 위해 각 대화 스레드를 개별적으로 저장합니다.
임베딩 캐싱 : 자동 캐싱을 갖춘 SentenceTransformer 사용
영구 저장소 : 데이터는 구성 가능한 저장소 디렉토리의 세션 간에 유지됩니다.
다중 플랫폼 지원 : 다양한 아키텍처에 최적화된 Docker 이미지
설정
필수 조건
다음 범위의 HubSpot 액세스 토큰이 필요합니다.
crm.objects.contacts(읽기/쓰기)
crm.objects.companies(읽기/쓰기)
판매-이메일-읽기
빠른 시작
# 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:latestDocker 구성
Claude 데스크톱에서 수동 구성:
{
"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"
]
}
}
}Docker 이미지 빌드
Docker 이미지를 로컬로 빌드하려면:
git clone https://github.com/buryhuang/mcp-hubspot.git
cd mcp-hubspot
docker build -t mcp-hubspot .다중 플랫폼 빌드의 경우:
docker buildx create --use
docker buildx build --platform linux/amd64,linux/arm64 -t buryhuang/mcp-hubspot:latest --push .개발
pip install -e .특허
MIT 라이센스
Available Tools
16 toolshubspot_create_companyC
Create a new company in HubSpot
Inputs: name (required), properties.
hubspot_create_contactC
Create a new contact in HubSpot
Inputs: lastname (required), firstname (required), email, properties.
hubspot_create_propertyB
Create a new custom property in HubSpot
Inputs: name (required), type (required), label (required), fieldType (required), +4 more.
hubspot_get_active_companiesB
Get most recently active companies from HubSpot
Inputs: limit.
hubspot_get_active_contactsB
Get most recently active contacts from HubSpot
Inputs: limit.
hubspot_get_companyB
Get a specific company by ID from HubSpot
Inputs: company_id (required), properties.
hubspot_get_company_activityC
Get activity history for a specific company
Inputs: company_id (required).
hubspot_get_contactC
Get a specific contact by ID from HubSpot
Inputs: contact_id (required), properties.
hubspot_get_propertyB
Get details of a specific HubSpot property definition
Inputs: object_type (required), property_name (required).
hubspot_get_recent_conversationsB
Get recent conversation threads from HubSpot with their messages
Inputs: after, limit, refresh_cache.
hubspot_get_ticket_conversation_threadsB
Get conversation threads associated with a specific ticket
Inputs: ticket_id (required).
hubspot_get_ticketsC
Get tickets from HubSpot based on configurable selection criteria
Inputs: limit, criteria, max_retries, retry_delay.
hubspot_search_dataB
Search for similar data in stored HubSpot API responses
Inputs: query (required), limit.
hubspot_update_companyC
Update an existing company record in HubSpot
Inputs: company_id (required), properties (required).
hubspot_update_contactB
Update an existing contact record in HubSpot
Inputs: contact_id (required), properties (required).
hubspot_update_propertyB
Update a HubSpot property definition (e.g., add dropdown options)
Inputs: options (required), object_type (required), property_name (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 16 tools
Most tools have distinct purposes (companies, contacts, properties, tickets, conversations), but 'hubspot_search_data' is vague and overlaps with the broader search concept, and 'get_active_companies' vs 'get_company' could cause confusion.
All tools follow a consistent 'hubspot_verb_noun' pattern in snake_case, making the naming predictable and easy to follow.
16 tools cover several CRM entities (companies, contacts, properties, tickets, conversations). The count is reasonable but slightly on the higher end for the breadth of operations provided.
While many core operations exist (create, get, update for companies/contacts/properties, get tickets), there are notable gaps: no delete operations, no ticket creation or update, no conversation creation, and missing ticket update.
Maintenance
Related MCP Connectors
The HubSpot MCP Server acts as a bridge that enables AI assistants and Large Language Models to securely interact with HubSpot CRM data through natural conversation, without requiring users to understand complex API structures. It provides read-only access to standard CRM objects (contacts, companies, deals, tickets, products, invoices, and more) and their associations, secured via OAuth 2.0, allowing AI agents to perform tasks like summarizing deals, fetching company updates, and looking up record changes.
Operate the Plixana CRM from any AI: contacts, deals, quotes, WhatsApp and metrics.
CRM, inbox, meetings, revenue intelligence, analytics and automations for AI agents.
Small business CRM: search and update contacts, companies, deals, sales pipeline, and tasks.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with HubSpot CRM for managing contacts, companies, deals, and sending emails through natural language commands.MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables management of HubSpot CRM entities including contacts, companies, deals, and pipelines through natural language. It provides comprehensive tools for listing, searching, creating, and updating records with support for OAuth 2.0 authentication.MIT
- AlicenseAqualityCmaintenanceExposes HubSpot CRM data and actions as tools for AI agents, enabling contact lookup, company search, contact creation, and activity logging via natural language.4MIT
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to HubSpot CRM, providing tools to manage contacts, companies, deals, and more via natural language.MIT