Skip to main content
Glama
enesjakozh
scopiousdigital

HubSpot MCP Server

by scopiousdigital
OverviewInspectSchemaRelated ServersScoreDiscussions
JavaScript
Remote

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 （数组）：要包含在结果中的属性列表

  • 返回：具有指定属性的公司详细信息

销售分析工具

  1. hubspot_get_sales_analytics

  • 获取特定时间段的汇总销售分析数据

  • 必需输入：

    • period （字符串）：按时间段对分析数据进行分组（每日、每周、每月、每季度、每年）

    • startDate （字符串）：分析开始日期，ISO 格式（YYYY-MM-DD）

  • 可选输入：

    • endDate （字符串）：ISO 格式的分析结束日期

    • pipeline （字符串）：要过滤的管道 ID

    • dealStage （字符串）：要过滤的交易阶段 ID

    • dealOwner （字符串）：要过滤的交易所有者 ID

  • 返回：按时间段分组的汇总销售指标

  1. hubspot_get_deal_history

  • 获取交易变更的完整历史记录

  • 必需输入：

    • dealId (string): 获取历史记录的交易的 ID

  • 返回：带有时间戳和修改属性的交易变更历史记录

  1. hubspot_get_deal_notes

  • 获取与特定交易相关的注释

  • 必需输入：

    • dealId (string): 需要获取注释的交易的 ID

  • 可选输入：

    • limit （数字，默认值：20）：返回的最大注释数

    • after （字符串）：下一页结果的分页光标

  • 返回：包含其内容和创建时间戳的笔记列表

  1. hubspot_get_engagements_by_deal

  • 获取与交易相关的所有参与活动

  • 必需输入：

    • dealId （字符串）：要获取约定的交易的 ID

  • 可选输入：

    • types （数组）：要包含的约定类型（电话、电子邮件、会议、任务、注释）

    • limit （数字，默认值：20）：返回的最大参与次数

    • after （字符串）：下一页结果的分页光标

  • 返回：参与列表及其详细信息和类型信息

  1. hubspot_get_sales_performance

  • 获取特定时间段内销售代表的绩效指标

  • 必需输入：

    • period （字符串）：按时间段对绩效数据进行分组（每日、每周、每月、每季度、每年）

    • startDate （字符串）：分析开始日期，ISO 格式（YYYY-MM-DD）

  • 可选输入：

    • endDate （字符串）：ISO 格式的分析结束日期

    • ownerIds （数组）：要包含在分析中的所有者 ID 列表

    • pipeline （字符串）：要过滤的管道 ID

  • 回报：每个销售代表的绩效指标，包括交易数量、收入和赢单率

  1. hubspot_get_pipeline_analytics

  • 获取特定销售渠道的分析数据，包括各阶段之间的转化率

  • 必需输入：

    • pipelineId （字符串）：要分析的管道的 ID

    • period （字符串）：按时间段对分析数据进行分组（每日、每周、每月、每季度、每年）

    • startDate （字符串）：分析开始日期，ISO 格式（YYYY-MM-DD）

  • 可选输入：

    • endDate （字符串）：ISO 格式的分析结束日期

  • 回报：管道阶段指标，包括交易数量、价值、转化率和阶段时间

  1. hubspot_get_forecast_analytics

  • 根据当前销售渠道和历史业绩获取预测销售数据

  • 必需输入：

    • period （字符串）：按预测数据分组的时间段（每月、每季度、每年）

  • 可选输入：

    • numberOfPeriods （数字，默认值：3）：要预测的未来周期数

    • pipeline （字符串）：要过滤的管道 ID

  • 回报：根据历史数据和当前渠道预测未来时期的销售指标

Related MCP server: HubSpot MCP

设置

  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

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

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

View all tools

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/scopiousdigital/hubspot-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server