HubSpot MCP

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

特性

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

安装

⚠️ 注意：由于此服务器上可用的端点数量众多，建议您安装并设置 Heimdall，以限制暴露给客户端应用程序的端点数量。

如果您没有API密钥，请按照此处的步骤获取访问令牌。

NPX（推荐）

将以下内容添加到您的MCP客户端 config.json 中（如果使用Heimdall，则为 ~/.heimdall/config.json）：

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

手动下载

1. 下载仓库：

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

1. 安装包（在克隆的仓库内）：

pnpm i

1. 将以下内容添加到您的MCP客户端 config.json 中（如果使用Heimdall，则为 ~/.heimdall/config.json）：

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

Smithery

要通过 Smithery 自动为Claude Desktop安装：

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

API 操作

核心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

• 基本操作：
  • 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: 更新多个联系人的状态

贡献

欢迎并鼓励贡献。如有任何问题、意见或建议，请联系 austin@shinzolabs.com。