HubSpot MCP 服务器

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

免责声明
此开源项目与 HubSpot 没有任何关联，也未获得 HubSpot 的认可。它是一个独立的实现，可与 HubSpot 的 API 进行交互。

工具

核心 CRM 工具

hubspot_search_contacts
- 使用查询字符串在 HubSpot 中搜索联系人
- 必需输入：
  - query （字符串）：搜索查询字符串（电子邮件、姓名等）
- 可选输入：
  - count （数字，默认值：10）：返回的最大联系人数量
  - propertyList （数组）：要包含在结果中的属性列表
- 返回：匹配的联系人及其属性的列表
hubspot_get_contact
- 通过 ID 获取特定联系人
- 必需输入：
  - contactId （字符串）：要检索的联系人的 ID
- 可选输入：
  - properties （数组）：要包含在结果中的属性列表
- 返回：具有指定属性的联系方式
hubspot_create_contact
- 在 HubSpot 中创建新联系人
- 必需输入：
  - properties （对象）：至少包含email字段的联系人属性
- 返回：创建的联系方式
hubspot_update_contact
- 更新 HubSpot 中的现有联系人
- 必需输入：
  - contactId （字符串）：要更新的联系人的 ID
  - properties （对象）：要更新的联系人属性
- 返回：更新的联系确认
hubspot_list_deals
- 使用分页功能列出 HubSpot 中的交易
- 可选输入：
  - limit （数字，默认值：10，最大值：100）：返回的最大交易数量
  - after （字符串）：下一页的分页光标
  - properties （数组）：要包含在结果中的属性列表
- 返回：交易列表及其详细信息
hubspot_get_deal
- 通过 ID 获取特定交易
- 必需输入：
  - dealId （字符串）：要检索的交易的 ID
- 可选输入：
  - properties （数组）：要包含在结果中的属性列表
- 返回：具有指定属性的交易详情
hubspot_create_deal
- 在 HubSpot 中创建新交易
- 必需输入：
  - properties （对象）：至少包含dealname字段的交易属性
- 返回：创建交易详情
hubspot_update_deal
- 更新 HubSpot 中的现有交易
- 必需输入：
  - dealId （字符串）：要更新的交易的ID
  - properties （对象）：要更新的交易属性
- 返回：更新交易确认
hubspot_list_companies
- 在 HubSpot 中分页列出公司
- 可选输入：
  - limit （数字，默认值：10，最大值：100）：返回的最大公司数量
  - after （字符串）：下一页的分页光标
  - properties （数组）：要包含在结果中的属性列表
- 返回：公司列表及其详细信息
hubspot_get_company

通过 ID 获取特定公司
必需输入：
- companyId （字符串）：要检索的公司 ID
可选输入：
- properties （数组）：要包含在结果中的属性列表
返回：具有指定属性的公司详细信息

销售分析工具

hubspot_get_sales_analytics

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

hubspot_get_deal_history

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

hubspot_get_deal_notes

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

hubspot_get_engagements_by_deal

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

hubspot_get_sales_performance

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

hubspot_get_pipeline_analytics

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

hubspot_get_forecast_analytics

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

设置

创建 HubSpot 私人应用程序：
- 转到您的 HubSpot 帐户
- 导航至“设置”→“帐户设置”→“集成”→“私人应用程序”
- 点击“创建私人应用”
- 为您的应用命名并设置适当的范围（联系人、交易和公司）
- 创建应用程序并复制您的私人应用程序令牌
所需范围：
- 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

{
  "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"
      }
    }
  }
}

故障排除

如果遇到错误，请验证：

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

建造

Docker 构建：

docker build -t mcp/hubspot -f Dockerfile .

执照

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

HubSpot MCP Server

Integrations