MCP 服务器

Hubspot

shinzo-labs

开发者工具

访问服务器

README

HubSpot MCP

一个为 HubSpot API 实现的模型上下文协议 (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"
      }
    }
  }
}

手动下载

下载仓库：

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

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

pnpm i

将以下内容添加到您的 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_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 Associations 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: 更新多个联系人的状态