MCP 服务器

HubSpot MCP Server

使Claude能够与HubSpot CRM互动，进行销售分析和洞察，并提供管理联系人、交易、公司以及检索销售分析数据的工具。

README

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 (字符串): 用于分组分析数据的时间段（daily、weekly、monthly、quarterly、yearly）
  - startDate (字符串): 分析的开始日期，采用 ISO 格式 (YYYY-MM-DD)
- 可选输入：
  - endDate (字符串): 分析的结束日期，采用 ISO 格式
  - pipeline (字符串): 要筛选的销售流程 ID
  - dealStage (字符串): 要筛选的交易阶段 ID
  - dealOwner (字符串): 要筛选的交易负责人 ID
- 返回：按时间段分组的聚合销售指标
hubspot_get_deal_history
- 获取交易的完整变更历史记录
- 必需输入：
  - dealId (字符串): 要获取历史记录的交易的 ID
- 返回：包含时间戳和修改属性的交易变更历史记录
hubspot_get_deal_notes
- 获取与特定交易关联的备注
- 必需输入：
  - dealId (字符串): 要获取备注的交易的 ID
- 可选输入：
  - limit (数字, 默认: 20): 要返回的最大备注数量
  - after (字符串): 下一页结果的分页游标
- 返回：包含其内容和创建时间戳的备注列表
hubspot_get_engagements_by_deal
- 获取与交易关联的所有互动活动
- 必需输入：
  - dealId (字符串): 要获取互动的交易的 ID
- 可选输入：
  - types (数组): 要包含的互动类型 (CALL, EMAIL, MEETING, TASK, NOTE)
  - limit (数字, 默认: 20): 要返回的最大互动数量
  - after (字符串): 下一页结果的分页游标
- 返回：包含其详细信息和类型信息的互动列表
hubspot_get_sales_performance
- 获取销售代表在特定时间段内的绩效指标
- 必需输入：
  - period (字符串): 用于分组绩效数据的时间段（daily、weekly、monthly、quarterly、yearly）
  - startDate (字符串): 分析的开始日期，采用 ISO 格式 (YYYY-MM-DD)
- 可选输入：
  - endDate (字符串): 分析的结束日期，采用 ISO 格式
  - ownerIds (数组): 要包含在分析中的负责人 ID 列表
  - pipeline (字符串): 要筛选的销售流程 ID
- 返回：每个销售代表的绩效指标，包括交易数量、收入和胜率
hubspot_get_pipeline_analytics
- 获取特定销售流程的分析数据，包括阶段之间的转化率
- 必需输入：
  - pipelineId (字符串): 要分析的销售流程的 ID
  - period (字符串): 用于分组分析数据的时间段（daily、weekly、monthly、quarterly、yearly）
  - startDate (字符串): 分析的开始日期，采用 ISO 格式 (YYYY-MM-DD)
- 可选输入：
  - endDate (字符串): 分析的结束日期，采用 ISO 格式
- 返回：销售流程阶段指标，包括交易数量、价值、转化率和阶段停留时间
hubspot_get_forecast_analytics
- 根据当前的销售流程和历史绩效获取预测的销售数据
- 必需输入：
  - period (字符串): 用于分组预测数据的时间段（monthly、quarterly、yearly）
- 可选输入：
  - 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"
      }
    }
  }
}

docker

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