Skip to main content
Glama
HubSpot MCP Server

HubSpot MCP Server

by baryhuang

허브스팟 MCP 서버

도커 허브 라이센스: MIT

개요

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_create_contact

중복 방지를 통해 연락처 생성

hubspot_create_company

중복 방지를 통해 기업을 만들어 보세요

hubspot_get_company_activity

특정 회사의 활동 검색

hubspot_get_active_companies

가장 최근에 활동한 회사 검색

hubspot_get_active_contacts

가장 최근에 활동한 연락처 검색

hubspot_get_recent_conversations

메시지가 포함된 최근 대화 스레드 검색

hubspot_search_data

이전에 검색된 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:latest

Docker 구성

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 tools
hubspot_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

    B3.2/5.0

    Scored across 16 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    All tools follow a consistent 'hubspot_verb_noun' pattern in snake_case, making the naming predictable and easy to follow.

    Tool Count4/5

    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.

    Completeness2/5

    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

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers