霍布斯波特-mcp

<div align="center"> <h1 align="center">HubSpot MCP 服务器</h1> <p align="center"> <a href="https://badge.fury.io/js/@shinzolabs%2Fhubspot-mcp"><img src="https://badge.fury.io/js/@shinzolabs%2Fhubspot-mcp.svg" alt="NPM 版本"></a> <a href="https://github.com/shinzo-labs/hubspot-mcp/stargazers"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.github.com%2Frepos%2Fshinzo-labs%2Fhubspot-mcp%2Fstargazers&query=%24.length&logo=github&label=stars&color=e3b341" alt="星标"></a> <a href="https://github.com/shinzo-labs/hubspot-mcp/forks"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.github.com%2Frepos%2Fshinzo-labs%2Fhubspot-mcp%2Fforks&query=%24.length&logo=github&label=forks&color=8957e5" alt="分叉"></a> <a href="https://smithery.ai/server/@shinzo-labs/hubspot-mcp"><img src="https://smithery.ai/badge/@shinzo-labs/hubspot-mcp" alt="Smithery 调用"></a> <a href="https://www.npmjs.com/package/@shinzolabs/hubspot-mcp"><img src="https://img.shields.io/npm/dm/%40shinzolabs%2Fhubspot-mcp" alt="NPM 下载量"></a> </p> </div>

这是一个用于 HubSpot API 的 模型上下文协议 (MCP) 服务器实现，提供了一个标准化接口来访问和管理 CRM 数据。

<p align="center"><img height="512" src="https://gips2.baidu.com/it/u=3405794166,2705930459&fm=3081&app=3081&f=GIF?w=838&h=1082"></p>

功能

• 完整覆盖 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

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

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	流式传输 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 是最后成功读取资源的分页游标标记，将作为包含更多结果的分页响应中的 paging.next.after JSON 属性返回。
• products_search: 搜索产品
• products_batch_create: 创建一批产品
• products_batch_read: 通过内部 ID 或唯一属性值读取一批产品。通过 idProperty 参数检索自定义唯一值属性的记录。
• products_batch_update: 通过内部 ID 或 idProperty 查询参数指定的唯一值更新一批产品。
• products_batch_archive: 通过 ID 归档一批产品

贡献

欢迎并鼓励贡献！请阅读 CONTRIBUTING.md 以了解关于问题、贡献和联系方式的指南。

数据收集和隐私

Shinzo Labs 从该服务器收集有限的匿名遥测数据，以帮助改进我们的产品和服务。此过程中不会收集任何个人身份信息。请参阅 隐私政策 以了解更多信息，包括如何退出此遥测。

许可证

MIT