HubSpot MCP Server

HubSpot 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 （数组）：要包含在结果中的属性列表
• 返回：具有指定属性的公司详细信息

销售分析工具

11. hubspot_get_sales_analytics

• 获取特定时间段的汇总销售分析数据
• 必需输入：
  • period （字符串）：按时间段对分析数据进行分组（每日、每周、每月、每季度、每年）
  • startDate （字符串）：分析开始日期，ISO 格式（YYYY-MM-DD）
• 可选输入：
  • endDate （字符串）：ISO 格式的分析结束日期
  • pipeline （字符串）：要过滤的管道 ID
  • dealStage （字符串）：要过滤的交易阶段 ID
  • dealOwner （字符串）：要过滤的交易所有者 ID
• 返回：按时间段分组的汇总销售指标

12. hubspot_get_deal_history

• 获取交易变更的完整历史记录
• 必需输入：
  • dealId (string): 获取历史记录的交易的 ID
• 返回：带有时间戳和修改属性的交易变更历史记录

13. hubspot_get_deal_notes

• 获取与特定交易相关的注释
• 必需输入：
  • dealId (string): 需要获取注释的交易的 ID
• 可选输入：
  • limit （数字，默认值：20）：返回的最大注释数
  • after （字符串）：下一页结果的分页光标
• 返回：包含其内容和创建时间戳的笔记列表

14. hubspot_get_engagements_by_deal

• 获取与交易相关的所有参与活动
• 必需输入：
  • dealId （字符串）：要获取约定的交易的 ID
• 可选输入：
  • types （数组）：要包含的约定类型（电话、电子邮件、会议、任务、注释）
  • limit （数字，默认值：20）：返回的最大参与次数
  • after （字符串）：下一页结果的分页光标
• 返回：参与列表及其详细信息和类型信息

15. hubspot_get_sales_performance

• 获取特定时间段内销售代表的绩效指标
• 必需输入：
  • period （字符串）：按时间段对绩效数据进行分组（每日、每周、每月、每季度、每年）
  • startDate （字符串）：分析开始日期，ISO 格式（YYYY-MM-DD）
• 可选输入：
  • endDate （字符串）：ISO 格式的分析结束日期
  • ownerIds （数组）：要包含在分析中的所有者 ID 列表
  • pipeline （字符串）：要过滤的管道 ID
• 回报：每个销售代表的绩效指标，包括交易数量、收入和赢单率

16. hubspot_get_pipeline_analytics

• 获取特定销售渠道的分析数据，包括各阶段之间的转化率
• 必需输入：
  • pipelineId （字符串）：要分析的管道的 ID
  • period （字符串）：按时间段对分析数据进行分组（每日、每周、每月、每季度、每年）
  • startDate （字符串）：分析开始日期，ISO 格式（YYYY-MM-DD）
• 可选输入：
  • endDate （字符串）：ISO 格式的分析结束日期
• 回报：管道阶段指标，包括交易数量、价值、转化率和阶段时间

17. hubspot_get_forecast_analytics

• 根据当前销售渠道和历史业绩获取预测销售数据
• 必需输入：
  • period （字符串）：按预测数据分组的时间段（每月、每季度、每年）
• 可选输入：
  • numberOfPeriods （数字，默认值：3）：要预测的未来周期数
  • pipeline （字符串）：要过滤的管道 ID
• 回报：根据历史数据和当前渠道预测未来时期的销售指标

设置

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中：

NPX

码头工人

故障排除

如果遇到错误，请验证：

1. 所有必需的范围都已添加到您的 HubSpot 私人应用中
2. API 密钥已正确复制到您的配置中
3. 您的 HubSpot 计划包含对您尝试使用的 API 的访问权限

建造

Docker 构建：

执照

此 MCP 服务器采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。