Skip to main content
Glama
enesjakozh
scopiousdigital

HubSpot MCP Server

by scopiousdigital
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Remote

허브스팟 MCP 서버

HubSpot API를 위한 MCP 서버를 사용하면 Claude가 HubSpot CRM과 상호 작용하여 판매 분석 및 통찰력을 얻을 수 있습니다.

부인 성명

이 오픈소스 프로젝트는 HubSpot과 제휴 관계가 없으며, HubSpot의 보증을 받지 않습니다. HubSpot API와 상호 작용하는 독립적인 구현체입니다.

도구

핵심 CRM 도구

  1. hubspot_search_contacts

    • 쿼리 문자열을 사용하여 HubSpot에서 연락처 검색

    • 필수 입력 사항:

      • query (문자열): 검색 쿼리 문자열(이메일, 이름 등)

    • 선택 입력 사항:

      • count (숫자, 기본값: 10): 반환할 최대 연락처 수

      • propertyList (배열): 결과에 포함할 속성 목록

    • 반환: 속성이 있는 일치하는 연락처 목록

  2. hubspot_get_contact

    • ID로 특정 연락처 가져오기

    • 필수 입력 사항:

      • contactId (문자열): 검색할 연락처의 ID

    • 선택 입력 사항:

      • properties (배열): 결과에 포함할 속성 목록

    • 반환: 지정된 속성에 대한 연락처 정보

  3. hubspot_create_contact

    • HubSpot에서 새 연락처 만들기

    • 필수 입력 사항:

      • properties (객체): 최소한 email 필드가 있는 연락처 속성

    • 반품: 연락처 정보가 생성되었습니다.

  4. hubspot_update_contact

    • HubSpot에서 기존 연락처 업데이트

    • 필수 입력 사항:

      • contactId (문자열): 업데이트할 연락처의 ID

      • properties (객체): 업데이트할 속성을 문의합니다.

    • 반품: 연락처 확인 업데이트됨

  5. hubspot_list_deals

    • 페이지네이션을 사용하여 HubSpot에 거래 목록 표시

    • 선택 입력 사항:

      • limit (숫자, 기본값: 10, 최대: 100): 반환할 최대 거래 수

      • after (문자열): 다음 페이지의 페이지 번호 커서

      • properties (배열): 결과에 포함할 속성 목록

    • 반품: 거래 목록 및 세부 정보

  6. hubspot_get_deal

    • ID로 특정 거래를 받으세요

    • 필수 입력 사항:

      • dealId (문자열): 검색할 거래의 ID

    • 선택 입력 사항:

      • properties (배열): 결과에 포함할 속성 목록

    • 반환: 지정된 속성에 대한 거래 세부 정보

  7. hubspot_create_deal

    • HubSpot에서 새 거래를 만듭니다

    • 필수 입력 사항:

      • properties (객체): 최소한 dealname 필드가 있는 거래 속성

    • 반품: 거래 세부정보 생성됨

  8. hubspot_update_deal

    • HubSpot에서 기존 거래 업데이트

    • 필수 입력 사항:

      • dealId (문자열): 업데이트할 거래의 ID

      • properties (객체): 업데이트할 거래 속성

    • 반품: 업데이트된 거래 확인

  9. hubspot_list_companies

    • 페이지 매김을 사용하여 HubSpot에 회사 목록 표시

    • 선택 입력 사항:

      • limit (숫자, 기본값: 10, 최대: 100): 반환할 최대 회사 수

      • after (문자열): 다음 페이지의 페이지 번호 커서

      • properties (배열): 결과에 포함할 속성 목록

    • 반환: 회사 목록 및 세부 정보

  10. hubspot_get_company

  • ID로 특정 회사 가져오기

  • 필수 입력 사항:

    • companyId (문자열): 검색할 회사의 ID

  • 선택 입력 사항:

    • properties (배열): 결과에 포함할 속성 목록

  • 반환: 지정된 속성을 포함하는 회사 세부 정보

영업 분석 도구

  1. hubspot_get_sales_analytics

  • 특정 기간 동안의 집계된 판매 분석 데이터를 얻으세요

  • 필수 입력 사항:

    • period (문자열): 분석 데이터를 그룹화할 기간(일별, 주별, 월별, 분기별, 연간)

    • startDate (문자열): ISO 형식(YYYY-MM-DD)의 분석 시작 날짜

  • 선택 입력 사항:

    • endDate (문자열): ISO 형식의 분석 종료 날짜

    • pipeline (문자열): 필터링할 파이프라인 ID

    • dealStage (문자열): 필터링할 거래 단계 ID

    • dealOwner (문자열): 필터링할 거래 소유자 ID

  • 반품: 기간별로 그룹화된 집계된 판매 지표

  1. hubspot_get_deal_history

  • 거래 변경 사항의 전체 내역을 확인하세요

  • 필수 입력 사항:

    • dealId (문자열): 내역을 가져올 거래의 ID

  • 반환: 타임스탬프 및 수정된 속성을 포함한 거래 변경 내역

  1. hubspot_get_deal_notes

  • 특정 거래와 관련된 메모를 받으세요

  • 필수 입력 사항:

    • dealId (문자열): 메모를 가져올 거래의 ID

  • 선택 입력 사항:

    • limit (숫자, 기본값: 20): 반환할 최대 노트 수

    • after (문자열): 다음 페이지 결과에 대한 페이지 번호 커서

  • 반환: 내용 및 생성 타임스탬프가 포함된 메모 목록

  1. hubspot_get_engagements_by_deal

  • 거래와 관련된 모든 참여 활동을 가져옵니다.

  • 필수 입력 사항:

    • dealId (문자열): 참여를 얻기 위한 거래의 ID

  • 선택 입력 사항:

    • types (배열): 포함할 참여 유형(통화, 이메일, 회의, 작업, 메모)

    • limit (숫자, 기본값: 20): 반환할 최대 참여 수

    • after (문자열): 다음 페이지 결과에 대한 페이지 번호 커서

  • 반환: 세부 정보 및 유형 정보가 포함된 참여 목록

  1. hubspot_get_sales_performance

  • 특정 기간 동안 영업 담당자의 성과 지표를 얻으세요

  • 필수 입력 사항:

    • period (문자열): 성과 데이터를 그룹화할 기간(일별, 주별, 월별, 분기별, 연간)

    • startDate (문자열): ISO 형식(YYYY-MM-DD)의 분석 시작 날짜

  • 선택 입력 사항:

    • endDate (문자열): ISO 형식의 분석 종료 날짜

    • ownerIds (배열): 분석에 포함할 소유자 ID 목록

    • pipeline (문자열): 필터링할 파이프라인 ID

  • 반품: 거래 수, 수익, 승률 등 각 영업 담당자의 성과 측정 항목

  1. hubspot_get_pipeline_analytics

  • 단계별 전환율을 포함한 특정 판매 파이프라인에 대한 분석을 받으세요

  • 필수 입력 사항:

    • pipelineId (문자열): 분석할 파이프라인의 ID

    • period (문자열): 분석 데이터를 그룹화할 기간(일별, 주별, 월별, 분기별, 연간)

    • startDate (문자열): ISO 형식(YYYY-MM-DD)의 분석 시작 날짜

  • 선택 입력 사항:

    • endDate (문자열): ISO 형식의 분석 종료 날짜

  • 반환: 거래 수, 가치, 전환율 및 단계 시간을 포함한 파이프라인 단계 측정 항목

  1. hubspot_get_forecast_analytics

  • 현재 파이프라인과 과거 실적을 기반으로 예상 판매 데이터를 얻으세요.

  • 필수 입력 사항:

    • period (문자열): 예측 데이터를 그룹화할 기간(월별, 분기별, 연간)

  • 선택 입력 사항:

    • numberOfPeriods (숫자, 기본값: 3): 예측할 미래 기간 수

    • pipeline (문자열): 필터링할 파이프라인 ID

  • 반환: 과거 데이터와 현재 파이프라인을 기반으로 미래 기간에 대한 예상 판매 지표

Related MCP server: HubSpot MCP

설정

  1. HubSpot 비공개 앱 만들기:

    • HubSpot 계정으로 이동하세요

    • 설정 → 계정 설정 → 통합 → 비공개 앱으로 이동합니다.

    • "비공개 앱 만들기"를 클릭하세요

    • 앱 이름을 지정하고 적절한 범위(연락처, 거래, 회사)를 설정합니다.

    • 앱을 생성하고 개인 앱 토큰을 복사하세요.

  2. 필수 범위:

    • crm.objects.contacts.read

    • crm.objects.contacts.write

    • crm.objects.deals.read

    • crm.objects.deals.write

    • crm.objects.companies.read

    • crm.objects.companies.write

    • crm.objects.owners.read

    • crm.objects.quotes.read

    • crm.objects.line_items.read

    • crm.objects.custom.read

    • crm.schemas.deals.read

    • crm.schemas.contacts.read

    • crm.schemas.companies.read

    • crm.schemas.custom.read

Claude Desktop과 함께 사용

claude_desktop_config.json 에 다음을 추가하세요.

엔피엑스

지엑스피1

도커

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "HUBSPOT_API_KEY", "mcp/hubspot"],
      "env": {
        "HUBSPOT_API_KEY": "your-api-key-here"
      }
    }
  }
}

문제 해결

오류가 발생하면 다음 사항을 확인하세요.

  1. 모든 필수 범위가 HubSpot 개인 앱에 추가되었습니다.

  2. API 키가 구성에 올바르게 복사되었습니다.

  3. 귀하의 HubSpot 플랜에는 사용하려는 API에 대한 액세스가 포함되어 있습니다.

짓다

Docker 빌드:

docker build -t mcp/hubspot -f Dockerfile .

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 약관에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

View all tools

Appeared in Searches

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/scopiousdigital/hubspot-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server