HelloWorld
登录
s

scopiousdigital

customer-data-platformsmarketingsearch

292 查看 · 2026-07-07 更新

HubSpot MCP 服务器

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

免责声明

此开源项目与 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 (数组)：结果中包含的属性列表
    • 返回：带有指定属性的公司详情

销售分析工具

  1. hubspot_get_sales_analytics

    • 获取特定时间段内的汇总销售分析数据
    • 必需输入：
      • period (字符串)：按时间周期分组的分析数据 (daily, weekly, monthly, quarterly, yearly)
      • startDate (字符串)：ISO 格式的分析开始日期 (YYYY-MM-DD)
    • 可选输入：
      • endDate (字符串)：ISO 格式的分析结束日期
      • pipeline (字符串)：过滤用的管道 ID
      • dealStage (字符串)：过滤用的交易阶段 ID
      • dealOwner (字符串)：过滤用的交易所有者 ID
    • 返回：按时间周期分组的汇总销售指标

  2. hubspot_get_deal_history

    • 获取交易的完整变更历史
    • 必需输入：- dealId (字符串): 要获取历史记录的交易ID
    • 返回: 包含时间戳和修改属性的交易变更历史

  3. hubspot_get_deal_notes

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

  4. hubspot_get_engagements_by_deal

    • 获取与交易相关的所有互动活动
    • 必需输入:
      • dealId (字符串): 要获取互动活动的交易ID
    • 可选输入:
      • types (数组): 要包含的互动类型 (CALL, EMAIL, MEETING, TASK, NOTE)
      • limit (数字, 默认值: 20): 返回的最大互动数量
      • after (字符串): 下一页结果的分页游标
    • 返回: 包含详细信息和类型信息的互动列表

  5. hubspot_get_sales_performance

    • 获取特定时间段内销售代表的业绩指标
    • 必需输入:
      • period (字符串): 按时间周期分组的业绩数据 (daily, weekly, monthly, quarterly, yearly)
      • startDate (字符串): 分析开始日期，ISO 格式 (YYYY-MM-DD)
    • 可选输入:
      • endDate (字符串): 分析结束日期，ISO 格式
      • ownerIds (数组): 要包含在分析中的所有者ID列表
      • pipeline (字符串): 用于过滤的管道ID
    • 返回: 每个销售代表的业绩指标，包括交易数量、收入和成交率

  6. hubspot_get_pipeline_analytics

    • 获取特定销售管道的分析数据，包括各阶段之间的转化率
    • 必需输入:
      • pipelineId (字符串): 要分析的管道ID
      • period (字符串): 按时间周期分组的分析数据 (daily, weekly, monthly, quarterly, yearly)
      • startDate (字符串): 分析开始日期，ISO 格式 (YYYY-MM-DD)
    • 可选输入:
      • endDate (字符串): 分析结束日期，ISO 格式
    • 返回: 管道阶段指标，包括交易数量、价值、转化率和阶段停留时间

  7. hubspot_get_forecast_analytics

    • 基于当前管道和历史表现获取预测销售数据
    • 必需输入:
      • period (字符串): 按时间周期分组的预测数据 (monthly, quarterly, yearly)
    • 可选输入:
      • 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

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

docker

json { "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构建命令：

bash docker build -t mcp/hubspot -f Dockerfile .

许可证

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

服务配置

[{'mcpServers': {'hubspot': {'args': ['-y', '@modelcontextprotocol/server-hubspot'], 'command': 'npx', 'env': {'HUBSPOT_API_KEY': 'your-api-key-here'}}}}, {'mcpServers': {'hubspot': {'args': ['run', '-i', '--rm', '-e', 'HUBSPOT_API_KEY', 'mcp/hubspot'], 'command': 'docker', 'env': {'HUBSPOT_API_KEY': 'your-api-key-here'}}}}]

来源