허브스팟 MCP

HubSpot API에 대한 MCP(모델 컨텍스트 프로토콜) 구현으로 CRM 데이터에 액세스하고 관리하기 위한 표준화된 인터페이스를 제공합니다.

특징

HubSpot CRM API에 대한 전체 내용
모든 표준 CRM 객체(회사, 연락처, 거래 등) 지원
CRM Associations v4를 통한 고급 협회 관리
속성 검증을 통한 회사별 엔드포인트
효율적인 데이터 관리를 위한 일괄 작업
고급 검색 및 필터링 기능
Zod 를 사용한 유형 안전 매개변수 검증

설치

⚠️ 참고: 이 서버에서 사용할 수 있는 엔드포인트 수가 많으므로 클라이언트 애플리케이션에 노출되는 엔드포인트 수를 제한하기 위해 Heimdall을 설치하고 설정하는 것이 좋습니다.

API 키가 없으면 여기의 단계에 따라 액세스 토큰을 얻으세요.

NPX (추천)

MCP 클라이언트 config.json 에 다음을 추가합니다(Heimdall을 사용하는 경우 ~/.heimdall/config.json ):

지엑스피1

수동 다운로드

리포지토리 다운로드:

git clone https://github.com/shinzo-labs/hubspot-mcp.git

패키지 설치(복제된 저장소 내부):

pnpm i

MCP 클라이언트 config.json 에 다음을 추가합니다(Heimdall을 사용하는 경우 ~/.heimdall/config.json ):

{
  "mcpServers": {
    "hubspot": {
      "command": "node",
      "args": [
        "/path/to/hubspot-mcp/index.js"
      ],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "your-token-here"
      }
    }
  }
}

대장간

Smithery를 통해 Claude Desktop을 자동으로 설치하려면:

npx -y @smithery/cli install @shinzo-labs/hubspot-mcp --client claude

API 작업

핵심 CRM 객체

기본 객체 작업

crm_list_objects : 선택적 필터링 및 페이지 매김을 사용하여 CRM 객체를 나열합니다.
crm_get_object : ID로 단일 CRM 객체를 가져옵니다.
crm_create_object : 새로운 CRM 객체를 생성합니다.
crm_update_object : 기존 CRM 객체 업데이트
crm_delete_object : CRM 객체 삭제

검색 및 일괄 작업

crm_search_objects : 고급 필터를 사용하여 CRM 객체 검색
crm_batch_create_objects : 단일 요청에서 여러 객체를 생성합니다.
crm_batch_update_objects : 단일 요청에서 여러 객체를 업데이트합니다.
crm_batch_delete_objects : 단일 요청에서 여러 객체를 삭제합니다.

CRM 레코드 관리

회사

기본 작업:
- crm_create_company : 검증된 속성을 사용하여 새 회사를 만듭니다.
- crm_update_company : 기존 회사 업데이트
- crm_get_company : ID로 단일 회사 가져오기
- crm_search_companies : 특정 필터로 회사 검색
배치 작업:
- crm_batch_create_companies : 단일 요청으로 여러 회사 생성
- crm_batch_update_companies : 단일 요청으로 여러 회사 업데이트
부동산 관리:
- crm_get_company_properties : 사용 가능한 모든 회사 속성을 가져옵니다.
- crm_create_company_property : 새로운 회사 속성을 만듭니다.

콘택트 렌즈

기본 작업:
- crm_create_contact : 검증된 속성을 사용하여 새 연락처를 만듭니다.
- crm_update_contact : 기존 연락처 정보 업데이트
- crm_get_contact : ID로 단일 연락처 가져오기
- crm_search_contacts : 특정 필터로 연락처 검색
배치 작업:
- crm_batch_create_contacts : 단일 요청으로 여러 연락처를 생성합니다.
- crm_batch_update_contacts : 단일 요청으로 여러 연락처 업데이트
부동산 관리:
- crm_get_contact_properties : 사용 가능한 모든 연락처 속성을 가져옵니다.
- crm_create_contact_property : 새 연락처 속성을 만듭니다.

리드

기본 작업:
- crm_create_lead : 검증된 속성으로 새 리드를 생성합니다.
- crm_update_lead : 기존 리드 정보 업데이트
- crm_get_lead : ID로 단일 리드 가져오기
- crm_search_leads : 특정 필터로 리드 검색
배치 작업:
- crm_batch_create_leads : 단일 요청으로 여러 리드 생성
- crm_batch_update_leads : 단일 요청으로 여러 리드 업데이트
부동산 관리:
- crm_get_lead_properties : 사용 가능한 모든 리드 속성을 가져옵니다.
- crm_create_lead_property : 새로운 리드 속성을 만듭니다.

참여 관리

약혼 세부 정보

기본 작업:
- engagement_details_get : 특정 참여에 대한 세부 정보를 가져옵니다.
- engagement_details_create : 새로운 참여를 만듭니다
- engagement_details_update : 기존 참여 업데이트
- engagement_details_delete : 약혼 삭제
- engagement_details_list : 필터링을 통해 모든 참여를 나열합니다.
- engagement_details_get_associated : 연관된 참여를 가져옵니다.

전화

기본 작업:
- calls_create : 새로운 통화 기록을 만듭니다
- calls_get : 통화 세부 정보 가져오기
- calls_update : 통화 기록 업데이트
- calls_archive : 통화를 보관합니다
- calls_list : 모든 통화를 나열합니다
- calls_search : 통화 검색
배치 작업:
- calls_batch_create : 여러 통화 생성
- calls_batch_read : 여러 호출을 읽습니다.
- calls_batch_update : 여러 호출 업데이트
- calls_batch_archive : 여러 통화를 보관합니다

이메일

기본 작업:
- emails_create : 새로운 이메일 레코드를 만듭니다.
- emails_get : 이메일 세부 정보 가져오기
- emails_update : 이메일 업데이트
- emails_archive : 이메일 보관
- emails_list : 모든 이메일 나열
- emails_search : 이메일 검색
배치 작업:
- emails_batch_create : 여러 개의 이메일 생성
- emails_batch_read : 여러 개의 이메일을 읽습니다.
- emails_batch_update : 여러 이메일 업데이트
- emails_batch_archive : 여러 개의 이메일을 보관합니다.

회의

기본 작업:
- meetings_create : 새로운 회의를 만듭니다
- meetings_get : 회의 세부 정보 가져오기
- meetings_update : 회의 업데이트
- meetings_delete : 회의 삭제
- meetings_list : 모든 회의를 나열합니다
- meetings_search : 회의 검색
배치 작업:
- meetings_batch_create : 여러 회의 만들기
- meetings_batch_update : 여러 회의 업데이트
- meetings_batch_archive : 여러 회의를 보관합니다

노트

기본 작업:
- notes_create : 새로운 노트를 만듭니다
- notes_get : 노트 세부 정보 가져오기
- notes_update : 메모 업데이트
- notes_archive : 메모 보관
- notes_list : 모든 노트를 나열합니다
- notes_search : 노트 검색
배치 작업:
- notes_batch_create : 여러 개의 노트를 만듭니다
- notes_batch_read : 여러 개의 노트 읽기
- notes_batch_update : 여러 개의 노트 업데이트
- notes_batch_archive : 여러 개의 노트를 보관합니다

작업

기본 작업:
- tasks_create : 새로운 작업을 생성합니다
- tasks_get : 작업 세부 정보 가져오기
- tasks_update : 작업 업데이트
- tasks_archive : 작업 보관
- tasks_list : 모든 작업 나열
- tasks_search : 작업 검색
배치 작업:
- tasks_batch_create : 여러 작업 생성
- tasks_batch_read : 여러 작업 읽기
- tasks_batch_update : 여러 작업 업데이트
- tasks_batch_archive : 여러 작업 보관

협회 및 관계

CRM 협회 v4

기본 작업:
- crm_list_association_types : 사용 가능한 연관 유형을 나열합니다.
- crm_get_associations : 객체 간의 모든 연결을 가져옵니다.
- crm_create_association : 협회를 생성합니다
- crm_delete_association : 연관관계 삭제
배치 작업:
- crm_batch_create_associations : 여러 연관관계 생성
- crm_batch_delete_associations : 여러 연관관계 삭제

커뮤니케이션 선호도

구독 관리

기본 작업:
- communications_get_preferences : 연락처 기본 설정 가져오기
- communications_update_preferences : 연락처 기본 설정 업데이트
- communications_unsubscribe_contact : 글로벌 구독 취소
- communications_subscribe_contact : 글로벌 구독
- communications_get_subscription_definitions : 구독 정의 가져오기
대량 작업:
- communications_get_subscription_status : 여러 연락처의 상태 가져오기
- communications_update_subscription_status : 여러 연락처의 상태 업데이트

기여하다

여러분의 참여를 환영하며 적극 권장합니다. 질문, 의견 또는 우려 사항이 있으시면 austin@shinzolabs.com 으로 연락해 주세요.

HubSpot MCP

Integrations