Hubspot

这是一个用于 HubSpot API 的 Model Context Protocol (MCP) 服务实现，提供用于访问和管理 CRM 数据的标准化接口。

功能

• 全面覆盖 HubSpot CRM API
• 支持所有标准 CRM 对象（公司、联系人、交易等）
• 通过 CRM Associations v4 进行高级关联管理
• 提供带属性验证的公司专用端点
• 批量操作，实现高效的数据管理
• 高级搜索和筛选功能
• 使用 Zod 进行类型安全的参数验证

前置条件

如果你没有 API 密钥，请按照此处的步骤获取访问令牌。计划在未来增强功能中支持 OAuth。

客户端配置

你可以通过多种方式配置 MCP 客户端以连接此服务。对于托管／远程服务设置，请使用 Smithery 的命令行 CLI 和 Smithery API 密钥。对于本地安装，可以使用 npx 或从源代码构建。下面将分别说明这些方式。

Smithery 远程服务（推荐）

若要将远程服务添加到 MCP 客户端的 config.json，请通过 Smithery CLI 运行以下命令：

npx -y @smithery/cli install @shinzo-labs/hubspot-mcp

出现提示时，输入你的 HUBSPOT_ACCESS_TOKEN。

Smithery SDK

如果你正在开发自己的 Agent 应用程序，可以使用此处的样板代码。

NPX 本地安装

若要使用 npx 在本地安装服务，请将以下内容添加到 MCP 客户端的 config.json：

{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": [
        "@shinzolabs/hubspot-mcp"
      ],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "your-access-token-here"
      }
    }
  }
}

从源代码构建

1. 下载仓库：

git clone https://github.com/shinzo-labs/hubspot-mcp.git

2. 安装软件包（在克隆的仓库中）：

pnpm i

3. 将以下内容添加到 MCP 客户端的 config.json：

{
  "mcpServers": {
    "hubspot": {
      "command": "node",
      "args": [
        "/path/to/hubspot-mcp/index.js"
      ],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "your-access-token-here"
      }
    }
  }
}

配置变量

变量	描述	必填？	默认值
HUBSPOT_ACCESS_TOKEN	Hubspot 应用程序的访问令牌	是
PORT	Streamable HTTP 传输方式使用的端口	否	3000
TELEMETRY_ENABLED	启用遥测	否	true

支持的工具

核心 CRM 对象

• crm_list_objects：列出 CRM 对象，支持可选的筛选和分页
• crm_get_object：根据 ID 获取单个 CRM 对象
• crm_create_object：创建新的 CRM 对象
• crm_update_object：更新现有 CRM 对象
• crm_archive_object：归档（删除）CRM 对象
• crm_search_objects：使用高级筛选条件搜索 CRM 对象
• crm_batch_create_objects：在单个请求中创建多个对象
• crm_batch_read_objects：在单个请求中读取多个对象
• crm_batch_update_objects：在单个请求中更新多个对象
• crm_batch_archive_objects：在单个请求中归档（删除）多个对象

公司

• crm_create_company：使用经过验证的属性创建新公司
• crm_update_company：更新现有公司
• crm_get_company：根据 ID 获取单个公司
• crm_search_companies：使用特定筛选条件搜索公司
• crm_batch_create_companies：在单个请求中创建多个公司
• crm_batch_update_companies：在单个请求中更新多个公司
• crm_get_company_properties：获取所有可用的公司属性
• crm_create_company_property：创建新的公司属性

联系人

• crm_create_contact：使用经过验证的属性创建新联系人
• crm_update_contact：更新现有联系人的信息
• crm_get_contact：根据 ID 获取单个联系人
• crm_search_contacts：使用特定筛选条件搜索联系人
• crm_batch_create_contacts：在单个请求中创建多个联系人
• crm_batch_update_contacts：在单个请求中更新多个联系人
• crm_get_contact_properties：获取所有可用的联系人属性
• crm_create_contact_property：创建新的联系人属性

潜在客户

• crm_create_lead：使用经过验证的属性创建新的潜在客户
• crm_update_lead：更新现有潜在客户的信息
• crm_get_lead：根据 ID 获取单个潜在客户
• crm_search_leads：使用特定筛选条件搜索潜在客户
• crm_batch_create_leads：在单个请求中创建多个潜在客户
• crm_batch_update_leads：在单个请求中更新多个潜在客户
• crm_get_lead_properties：获取所有可用的潜在客户属性
• crm_create_lead_property：创建新的潜在客户属性

互动管理

• engagement_details_get：获取特定互动的详细信息
• engagement_details_create：创建新的互动
• engagement_details_update：更新现有互动
• engagement_details_archive：归档（删除）互动
• engagement_details_list：列出所有互动，支持筛选
• engagement_details_get_associated：获取关联的互动

通话

• calls_create：创建新的通话记录
• calls_get：获取通话详情
• calls_update：更新通话记录
• calls_archive：归档通话
• calls_list：列出所有通话
• calls_search：搜索通话
• calls_batch_create：创建多个通话
• calls_batch_read：读取多个通话
• calls_batch_update：更新多个通话
• calls_batch_archive：归档多个通话

电子邮件

• emails_create：创建新的电子邮件记录
• emails_get：获取电子邮件详情
• emails_update：更新电子邮件
• emails_archive：归档电子邮件
• emails_list：列出所有电子邮件
• emails_search：搜索电子邮件
• emails_batch_create：创建多封电子邮件
• emails_batch_read：读取多封电子邮件
• emails_batch_update：更新多封电子邮件
• emails_batch_archive：归档多封电子邮件

会议

• meetings_create：创建新会议
• meetings_get：获取会议详情
• meetings_update：更新会议
• meetings_archive：归档（删除）会议
• meetings_list：列出所有会议
• meetings_search：搜索会议
• meetings_batch_create：创建多个会议
• meetings_batch_update：更新多个会议
• meetings_batch_archive：归档多个会议

备注

• notes_create：创建新备注
• notes_get：获取备注详情
• notes_update：更新备注
• notes_archive：归档备注
• notes_list：列出所有备注
• notes_search：搜索备注
• notes_batch_create：创建多个备注
• notes_batch_read：读取多个备注
• notes_batch_update：更新多个备注
• notes_batch_archive：归档多个备注

任务

• tasks_create：创建新任务
• tasks_get：获取任务详情
• tasks_update：更新任务
• tasks_archive：归档任务
• tasks_list：列出所有任务
• tasks_search：搜索任务
• tasks_batch_create：创建多个任务
• tasks_batch_read：读取多个任务
• tasks_batch_update：更新多个任务
• tasks_batch_archive：归档多个任务

关联与关系

• crm_list_association_types：列出可用的关联类型
• crm_get_associations：获取对象之间的所有关联
• crm_create_association：创建关联
• crm_archive_association：归档（删除）关联
• crm_batch_create_associations：创建多个关联
• crm_batch_archive_associations：归档（删除）多个关联

通信偏好设置

• communications_get_preferences：获取联系人偏好设置
• communications_update_preferences：更新联系人偏好设置
• communications_unsubscribe_contact：全局取消订阅
• communications_subscribe_contact：全局订阅
• communications_get_subscription_definitions：获取订阅定义
• communications_get_subscription_status：获取多个联系人的状态
• communications_update_subscription_status：更新多个联系人的状态

产品

• products_create：使用给定属性创建产品，并返回对象副本，其中包含 ID。
• products_read：读取由 ID 标识的对象
• products_update：对由 ID 标识的对象执行部分更新。只读属性和不存在的属性会导致错误。传入空字符串可清除属性值。
• products_archive：将由 ID 标识的对象移至回收站。
• products_list：读取一页产品。通过 properties 查询参数控制返回内容。若分页响应中包含更多结果，最后成功读取的资源的分页游标令牌 after 将作为 JSON 属性 paging.next.after 返回。
• products_search：搜索产品
• products_batch_create：批量创建产品
• products_batch_read：通过内部 ID 或唯一属性值批量读取产品。使用 idProperty 参数，可通过自定义唯一值属性检索记录。
• products_batch_update：通过内部 ID 或 idProperty 查询参数指定的唯一值批量更新产品。
• products_batch_archive：通过 ID 批量归档产品

贡献

欢迎并鼓励大家贡献！请阅读 CONTRIBUTING.md，了解问题反馈、贡献和联系信息方面的指南。

数据收集与隐私

Shinzo Labs 会从此服务收集有限的匿名遥测数据，以帮助改进我们的产品和服务。此过程不会收集任何个人身份信息。请查看 隐私政策，了解收集的数据类型以及如何选择退出此遥测的更多详情。

许可证

MIT