HubSpot MCP

HubSpot MCP

HubSpot API 的模型上下文协议 (MCP)实现，为访问和管理 CRM 数据提供了标准化接口。

特征

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

先决条件

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

客户端配置

您可以通过多种方式配置 MCP 客户端和服务器。对于托管/远程服务器设置，请使用 Smithery 的 CLI 和Smithery API 密钥。对于本地安装，请使用npx或从源代码构建。以下将逐一解释这些选项。

Smithery 远程服务器（推荐）

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

出现提示时输入您的HUBSPOT_ACCESS_TOKEN 。

Smithery SDK

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

NPX 本地安装

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

从源代码构建

1. 下载 repo：

2. 安装软件包（在克隆的 repo 内）：

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

配置变量

支持的工具

核心 CRM 对象

基本对象操作

• crm_list_objects ：列出 CRM 对象，并可选过滤和分页
• crm_get_object ：通过 ID 获取单个 CRM 对象
• crm_create_object ：创建一个新的 CRM 对象
• crm_update_object ：更新现有的 CRM 对象
• crm_delete_object ：删除 CRM 对象

搜索和批量操作

• crm_search_objects ：使用高级过滤器搜索 CRM 对象
• crm_batch_create_objects ：在单个请求中创建多个对象
• crm_batch_update_objects ：在单个请求中更新多个对象
• crm_batch_delete_objects ：在单个请求中删除多个对象

CRM记录管理

公司

• 基本操作：
  • 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_delete ：删除约会
  • 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_delete ：删除会议
  • 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 协会 v4

• 基本操作：
  • crm_list_association_types ：列出可用的关联类型
  • crm_get_associations ：获取对象之间的所有关联
  • crm_create_association ：创建关联
  • crm_delete_association ：删除关联
• 批量操作：
  • crm_batch_create_associations ：创建多个关联
  • crm_batch_delete_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 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文件，获取问题、贡献指南和联系信息。