AI导哈

HubSpot扩展MCP服务器

一个扩展HubSpot功能的模型上下文协议(MCP)服务器,提供营销邮件、序列和工作流注册功能。

  • by brentwpeterson
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 brentwpeterson/mcp-hubspot-extended

使用说明

HubSpot扩展MCP服务器

一种模型上下文协议（MCP）服务器，扩展了Claude Code的HubSpot功能，添加了营销电子邮件、序列和工作流注册功能。

为什么存在

此服务器正在成长为 独立、多租户 Content Cucumber拥有HubSpot MCP，因此它可以为CC和每个客户端门户提供服务，因此我们不依赖于HubSpot自己的服务器。从v0.3.0开始，它移植了官方服务器的 核心CRM工具 （搜索、读取、创建、更新、属性、关联、模式、工作流）以及它已经拥有的营销/序列/工作流插件：

  • 核心CRM （v0.3.0中的新功能）：搜索、列表、批量读取、创建、更新、批量创建/更新对象；列出/获取/创建/更新属性；图式；列出/获取定义/批量创建关联；列出/获取工作流；账户详情
  • 营销电子邮件管理（列表、创建、更新、克隆、删除）
  • 电子邮件统计和性能数据
  • 销售顺序（列表、查看、注册联系人）
  • 工作流注册（注册/取消注册联系人）

一旦核心CRM平价得到充分行使，多租户客户路由成功，官方 @hubspot/mcp-server 条目可以退役（参见待办事项列表 6a3ec7413fd534dd5e72ba75).

先决条件

  • Node.js 20或更高版本
  • HubSpot帐户：
    • Marketing Hub Pro（用于营销电子邮件）
    • Sales Hub Pro（用于序列）
  • HubSpot私人应用程序，具有适当的范围

设置

1.创建HubSpot私人应用程序

  1. 首选 设置>集成>私人应用 HubSpot
  2. 点击 创建私人应用程序
  3. 命名它（例如，“克劳德代码MCP”）
  4. 在...之下 范围，启用：
    • content （用于营销电子邮件）
    • marketing-email （用于电子邮件操作）
    • automation （用于序列和工作流）
    • sales-email-read （用于序列）
  5. 点击 创建应用程序 并复制访问令牌

2.安装和构建

cd /Users/brent/scripts/CB-Workspace/mcp-servers/hubspot-extended
npm install
npm run build

3.配置克劳德代码

添加到您的Claude Code MCP配置中(~/.claude.json 或项目 .mcp.json):

{
  "mcpServers": {
    "hubspot-extended": {
      "command": "node",
      "args": ["/Users/brent/scripts/CB-Workspace/mcp-servers/hubspot-extended/dist/index.js"],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "your-private-app-token"
      }
    }
  }
}

重新启动Claude Code以加载服务器。

多租户路由（v0.5.0）

一台服务器，多个客户端门户。代币来自两个来源，合并：

  1. HUBSPOT_ACCESS_TOKEN --成为 默认客户端 (HUBSPOT_DEFAULT_CLIENT，默认为 cc)
  2. HUBSPOT_TOKENS_FILE --通往a的道路 chmod-600 JSON文件 将客户端slug映射到令牌：
{
  "cc": "pat-na1-...",
  "acme": "pat-na1-...",
  "globex": "pat-na1-..."
}

每个工具都接受一个可选 client 鼻涕虫。决议是 严格:

  • client 省略→ 默认客户端(cc).
  • client 是一种已知的蛞蝓→ 那个门户的令牌。
  • client 是一个 未知 slug → 硬错误服务器永远不会悄无声息地回退到另一个门户——错误的门户写入必须大声失败，而不是悄悄地落在错误的客户端上。

向后兼容：仅与 HUBSPOT_ACCESS_TOKEN set（无令牌文件），服务器的行为与客户端的单个门户服务器完全相同 cc.

要添加客户端：使用新的slug创建/扩展chmod-600 JSON文件→令牌，并设置 HUBSPOT_TOKENS_FILE 在服务器的 .mcp.json env块（do 不 在中硬编码令牌 .mcp.json).

可用工具

核心客户关系管理（v0.3.0）

工具 说明
hubspot_search_objects 使用筛选器组、排序和属性搜索任何对象类型
hubspot_list_objects 列出对象类型的记录
hubspot_batch_read_objects 按id（或唯一属性）读取多条记录
hubspot_create_object 创建单个记录
hubspot_update_object 按id更新单个记录
hubspot_batch_create_objects 创建多条记录
hubspot_batch_update_objects 更新多条记录
hubspot_list_properties 列出对象类型的属性定义
hubspot_get_property 获取一个属性定义
hubspot_create_property 创建属性
hubspot_update_property 更新属性
hubspot_get_schemas 列出CRM对象架构（包括自定义对象）
hubspot_list_associations 列出与记录关联的记录
hubspot_get_association_definitions 列出两种对象类型之间的关联标签
hubspot_batch_create_associations 创建多个关联
hubspot_list_workflows 列出自动化工作流程
hubspot_get_workflow 获取一个工作流
hubspot_get_account_details 已连接的门户信息（id、时区、货币）

业务（任务、笔记、电话、电子邮件、会议）是CRM对象——使用匹配的对象工具 objectType 而不是专用的参与工具。

尚未移植： get_link / generate_feedback_link （HubSpot MCP UI深度链接便利）。 get_user_details 近似为 hubspot_get_account_details.

营销电子邮件

工具 说明
hubspot_list_marketing_emails 列出带有过滤选项的营销电子邮件
hubspot_get_marketing_email 获取特定电子邮件的完整详细信息
hubspot_create_marketing_email 创建新的营销电子邮件
hubspot_update_marketing_email 更新现有电子邮件
hubspot_clone_marketing_email 克隆电子邮件以创建新电子邮件
hubspot_delete_marketing_email 删除营销电子邮件
hubspot_get_marketing_email_statistics 获取电子邮件性能统计数据

序列

工具 说明
hubspot_list_sequences 列出所有销售序列
hubspot_get_sequence 获取特定序列的详细信息
hubspot_enroll_in_sequence 按顺序注册联系人
hubspot_get_sequence_enrollment 检查联系人是否已登记在序列中
hubspot_unenroll_from_sequence 从序列中取消联系人登记

工作流

工具 说明
hubspot_enroll_in_workflow 在工作流中注册联系人
hubspot_unenroll_from_workflow 从工作流中取消联系人登记

使用示例

营销电子邮件

List my marketing emails from the last week

Create a new marketing email named "January Newsletter" with subject "Your January Update"

序列

List all my sales sequences

Enroll contact 12345 in sequence 67890 using my email address

工作流

Enroll contact 12345 in workflow 99999

重要提示

序列需要用户ID

序列API需要 userId 参数（HubSpot所有者ID）。您可以从以下网址获得此信息：

  • HubSpot所有者API： GET /crm/v3/owners
  • 您的HubSpot用户设置

工作流注册限制

  • 仅适用于基于联系人的工作流
  • 较新的v4工作流可能具有与UI中显示的不同的ID
  • 官方HubSpot MCP可以列出/获取工作流；此服务器添加注册

所需范围

范围 目的
content 访问营销内容
marketing-email 全面的营销电子邮件操作
automation 序列和工作流程
sales-email-read 读取序列数据

局限性

  • 销售模板：HubSpot不提供对销售电子邮件模板（对话>模板）的API访问。这是HubSpot的限制。
  • 序列模板：无法通过API修改序列电子邮件模板。
  • 发布电子邮件：需要Marketing Hub Enterprise或事务电子邮件插件。

与HubSpot MCP官方的关系

此服务器是 互补的 致官方 @hubspot/mcp-server。您可以同时运行以下两项：

功能 官方MCP 此服务器
CRM对象 读写 读写（v0.3.0）
属性/模式/关联 是 是（v0.3.0）
工作流 列表、获取 列表、获得、注册、取消注册
营销电子邮件 - 完整CRUD
序列 - 列表、获取、注册
多租户（多个门户） 否（单个门户） 计划中

目标：一旦完全执行奇偶校验并实现多租户路由，此服务器将完全取代官方服务器。

发展

# Watch mode for development
npm run dev

# Build for production
npm run build

# Start the server directly
npm start

更新日志

v0.5.0

  • 多租户令牌路由： {clientSlug: token} 来自chmod-600 HUBSPOT_TOKENS_FILE，再加上遗产 HUBSPOT_ACCESS_TOKEN 作为默认客户端。每个请求令牌上下文通过 AsyncLocalStorage （并发安全）。
  • 每个工具都接受一个可选 client 鼻涕虫。未知slug=硬错误；没有静默回退到另一个门户（因此错误的门户写入会大声失败）。
  • 向后兼容：单令牌设置不变（默认客户端 cc).

v0.4.0

  • 添加 hubspot_get_user_details （令牌信息+解析的所有者+帐户信息，镜像官方工具；使用私有应用令牌信息端点，因为OAuth自检为返回null pat- 代币）以及 hubspot_create_engagement （注释/任务/等，带有关联，输入形状与官方工具相同）
  • 已验证与实时CC门户的写入奇偶校验（创建+删除了一个NOTE约定；用户详细信息解析了所有者ID 378618219）
  • 此服务器现在是唯一的HubSpot MCP。 所有工作空间消费者（技能、命令、布伦特启动例程步骤4和9.96）都从 mcp__hubspot__* 到 mcp__hubspot-extended__*和官方 @hubspot/mcp-server 条目已从中删除 .mcp.json

v0.3.0

  • 从官方服务器移植核心CRM工具：搜索/列表/批读取/创建/更新/批创建/批更新对象、列表/获取/创建/更改属性、模式、列表/获得定义/批创建关联、列表/捕获工作流、帐户详细信息
  • 已验证实时CC门户的读取路径奇偶性（过期任务搜索返回的计数与官方服务器相同，为38）
  • 迈向退休 @hubspot/mcp-server （积压 6a3ec7413fd534dd5e72ba75)

v0.2.0版本

  • 添加了序列工具（列表、获取、注册、取消注册）
  • 添加了工作流注册工具

v0.1.0

  • 首次发布营销电子邮件工具

许可证

麻省理工学院

相关 MCP