AI导哈

HubSpot CRM 交互服务

一个与HubSpot CRM API交互的开源服务，支持销售分析和洞察功能。

  • by scopiousdigital
  • JavaScript
  • 本地部署
  • 11 星标
  • 更新于
在 GitHub 查看 scopiousdigital/hubspot-mcp

使用说明

HubSpot MCP服务器

用于HubSpot API的MCP服务器，使Claude能够与HubSpot CRM进行交互，以进行销售分析和见解。

免责声明

这个开源项目与HubSpot无关，也没有得到HubSpot的认可。它是一个独立的实现，与HubSpot的API交互。

工具

核心CRM工具

  1. hubspot_search_contacts

    • 使用查询字符串在HubSpot中搜索联系人
    • 所需输入：
      • query （string）：搜索查询字符串（电子邮件、姓名等）
    • 可选输入：
      • count （数字，默认值：10）：要返回的最大联系人数
      • propertyList （array）：要包含在结果中的属性列表
    • 返回：匹配联系人及其属性的列表

  2. hubspot_get_contact

    • 通过ID获取特定联系人
    • 所需输入：
      • contactId （string）：要检索的联系人的ID
    • 可选输入：
      • properties （array）：要包含在结果中的属性列表
    • 返回：具有指定属性的联系方式

  3. hubspot_create_contact

    • 在HubSpot中创建新联系人
    • 所需输入：
      • properties （object）：至少具有以下联系属性 email 领域
    • 返回：已创建联系方式

  4. hubspot_update_contact

    • 更新HubSpot中的现有联系人
    • 所需输入：
      • contactId （string）：要更新的联系人的ID
      • properties （对象）：要更新的联系人属性
    • 返回：更新联系人确认

  5. hubspot_list_deals

    • 在HubSpot中列出交易并分页
    • 可选输入：
      • limit （数字，默认值：10，最大值：100）：要返回的最大交易数
      • after （string）：下一页的分页光标
      • properties （array）：要包含在结果中的属性列表
    • 退货：交易清单及其详细信息

  6. hubspot_get_deal

    • 按ID获取特定交易
    • 所需输入：
      • dealId （string）：要检索的交易的ID
    • 可选输入：
      • properties （array）：要包含在结果中的属性列表
    • 返回：具有指定属性的交易详细信息

  7. hubspot_create_deal

    • 在HubSpot创建新交易
    • 所需输入：
      • properties （object）：至少处理属性 dealname 领域
    • 退货：已创建交易详情

  8. hubspot_update_deal

    • 更新HubSpot中的现有交易
    • 所需输入：
      • dealId （string）：要更新的交易ID
      • properties （对象）：要更新的交易属性
    • 退货：更新交易确认

  9. hubspot_list_companies

    • 在HubSpot中列出公司并分页
    • 可选输入：
      • limit （数字，默认值：10，最大值：100）：要返回的最大公司数
      • after （string）：下一页的分页光标
      • properties （array）：要包含在结果中的属性列表
    • 返回：公司列表及其详细信息

  10. hubspot_get_company

    • 通过ID获取特定公司
    • 所需输入：
      • companyId （string）：要检索的公司的ID
    • 可选输入：
      • properties （array）：要包含在结果中的属性列表
    • 返回：具有指定属性的公司详细信息

销售分析工具

  1. hubspot_get_sales_analytics

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

  2. hubspot_get_deal_history

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

  3. hubspot_get_deal_notes

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

  4. hubspot_get_engagements_by_deal

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

  5. hubspot_get_sales_performance

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

  6. hubspot_get_pipeline_analytics

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

  7. hubspot_get_forecast_analytics

    • 根据当前渠道和历史业绩获取预测销售数据
    • 所需输入：
      • period （string）：按（月度、季度、年度）对预测数据进行分组的时间段
    • 可选输入：
      • numberOfPeriods （数字，默认值：3）：要预测的未来期数
      • pipeline （string）：要筛选的管道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:

新巴拿马型船舶

{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-hubspot"],
      "env": {
        "HUBSPOT_API_KEY": "your-api-key-here"
      }
    }
  }
}

码头工人

{
  "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文件。

相关 MCP