HubSpot MCP

by shinzo-labs
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides a standardized interface for accessing and managing HubSpot CRM data, including operations for companies, contacts, deals, tickets, and other CRM objects. Supports advanced association management, batch operations, search functionality, and property validation for efficient CRM data management.

  • Leverages Zod for type-safe parameter validation across all HubSpot API operations, ensuring data integrity when working with CRM objects and their properties.

HubSpot MCP

HubSpot API 的模型上下文协议 (MCP)实现,为访问和管理 CRM 数据提供了标准化接口。

特征

  • 全面覆盖 HubSpot CRM API
  • 支持所有标准 CRM 对象(公司、联系人、交易等)
  • 使用 CRM Associations v4 进行高级关联管理
  • 具有属性验证的公司特定端点
  • 批量操作,高效数据管理
  • 高级搜索和过滤功能
  • 使用Zod进行类型安全参数验证

安装

⚠️ 注意:由于此服务器上可用的端点数量众多,建议您安装并设置Heimdall以限制暴露给客户端应用程序的端点数量。

如果您没有 API 密钥,请按照此处的步骤获取访问令牌。

NPX(推荐)

将以下内容添加到您的 MCP 客户端config.json (如果使用 Heimdall ~/.heimdall/config.json ):

{ "mcpServers": { "hubspot": { "command": "npx", "args": [ "@shinzolabs/hubspot-mcp" ], "env": { "HUBSPOT_ACCESS_TOKEN": "your-token-here" } } } }

手册下载

  1. 下载 repo:
git clone https://github.com/shinzo-labs/hubspot-mcp.git
  1. 安装软件包(在克隆的 repo 内):
pnpm i
  1. 将以下内容添加到您的 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

You must be authenticated.

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

使用我们 HubSpot MCP 实施中的 100 多种工具无缝访问和管理您的 CRM 数据,包括联系人、公司和协会的操作。

  1. Features
    1. Installation
      1. NPX (Recommended)
      2. Manual Download
      3. Smithery
    2. API Operations
      1. Core CRM Objects
      2. CRM Records Management
      3. Engagement Management
      4. Associations and Relationships
      5. Communication Preferences
    3. Contributing
      ID: rvn6na254i