Hubspot MCP Tools

HubSpot MCP服务器

一个模型上下文协议（MCP）服务器，提供与HubSpot CRM API的无缝集成。该服务器使Claude Desktop和其他MCP客户端能够通过自然语言管理HubSpot资源并直接执行CRM操作。

87+综合工具 涵盖完整的HubSpot CRM工作流程，包括联系人、公司、交易、票务、笔记、约定（电话、电子邮件、会议、任务）、工作流程、关联、所有者、管道和物业管理。

用法

与任何兼容MCP的客户端一起使用，如Claude/Cursor/VS Code。将以下配置添加到MCP设置中：

{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": ["-y", "hubspot-mcp-tools"],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "your_access_token_here"
      }
    }
  }
}

替换 your_access_token_here 使用您的HubSpot私人应用访问令牌。

可用工具

联系API（9个工具）

• hubspot_create_contact -在HubSpot中创建新联系人
• hubspot_get_contact -从HubSpot获取ID联系人
• hubspot_list_contacts -按页码列出联系人
• hubspot_search_contacts -通过电子邮件、姓名或其他具有高级过滤功能的属性搜索联系人
• hubspot_update_contact -更新联系人属性
• hubspot_delete_contact -存档（软删除）联系人
• hubspot_batch_create_contacts -一次创建多个联系人（最多100个）
• hubspot_batch_update_contacts -一次更新多个联系人（最多100个）

公司API（9个工具）

• hubspot_create_公司 -在HubSpot创建新公司
• hubspot_get_公司 -从HubSpot获取公司ID
• hubspot_list_公司 -按页码列出公司
• hubspot_search_公司 -使用高级筛选按名称、域或其他属性搜索公司
• hubspot_update_公司 -更新公司属性
• hubspot_delete_公司 -将公司存档（软删除）
• hubspot_batch_create_公司 -一次创建多家公司（最多100家）
• hubspot_batch_update_公司 -一次更新多个公司（最多100个）

交易API（9个工具）

• hubspot_create_deal -在HubSpot中创建新交易（使用 hubspot_get_pipelines 对于可用的管道/阶段）
• hubspot_get_deal -从HubSpot获取ID交易
• hubspot_list_deals -列表处理分页
• hubspot_search_deals -使用高级筛选按名称、阶段、金额或其他属性搜索交易
• hubspot_update_deal -更新交易属性
• hubspot_delete_dal -存档（软删除）交易
• hubspot_batch_create_deals -一次创建多笔交易（最多100笔）
• hubspot_batch_update_deals -一次更新多笔交易（最多100笔）

门票API（9个工具）

• hubspot_create_ticket -在HubSpot中创建新票证（使用 hubspot_get_pipelines 对于可用的管道/阶段）
• hubspot_get_ticket -从HubSpot获取ID票
• hubspot_list_tickets -按页码列出门票
• hubspot_search_门票 -使用高级筛选按主题、状态或其他属性搜索门票
• hubspot_update_ticket -更新票证属性
• hubspot_delete_ticket -存档（软删除）票证
• hubspot_batch_create_门票 -一次创建多张票（最多100张）
• hubspot_batch_update_tickets -一次更新多张票（最多100张）

注释API（7个工具）

• hubspot_create_note -创建注释，并可选择与HubSpot对象关联
• hubspot_get_note -通过ID获取特定注释
• hubspot_get_object_notes -获取与HubSpot对象关联的笔记
• hubspot_list_notes -列出所有带页码的笔记
• hubspot_update_note -更新笔记内容或属性
• hubspot_delete_note -存档（软删除）笔记
• hubspot_search_notes -按内容或属性搜索笔记

调用API（6个工具）

• hubspot_create_call -记录通话内容，包括方向、状态、持续时间和可选的CRM关联
• hubspot_get_call -通过ID获取特定呼叫
• hubspot_list_calls -列出所有带分页的呼叫
• hubspot_update_call -更新通话属性
• hubspot_delete_call -存档（软删除）通话
• hubspot_search_calls -按属性或全文查询搜索调用

电子邮件API（6个工具）

• hubspot_create_email -使用可选的CRM关联记录电子邮件参与（发送、接收、转发）
• hubspot_get_email_engagement -通过ID获取特定的电子邮件参与
• hubspot_list_email_engagements -按页码列出所有电子邮件活动
• 现场更新Gemeine -更新电子邮件参与属性
• hubspot_delete_email_engagement -存档（软删除）电子邮件预约
• hubspot_search_email_engagements -搜索电子邮件活动

会议API（6个工具）

• hubspot_create_meeting -使用标题、议程、开始/结束时间、结果和可选的CRM关联记录会议
• hubspot_get_meeting -按ID获取特定会议
• hubspot_list_meetings -按页码列出所有会议
• hubspot_update_meeting -更新会议属性
• hubspot_delete_会议 -存档（软删除）会议
• hubspot_search_meetings -按属性或全文查询搜索会议

任务API（6个工具）

• hubspot_create_task -创建具有主题、优先级、类型、截止日期和可选CRM关联的任务
• hubspot_get_task -按ID获取特定任务
• hubspot_list_tasks -列出所有分页任务
• hubspot_update_task -更新任务属性或标记为已完成
• hubspot_delete_task -存档（软删除）任务
• hubspot_search_tasks -按状态、优先级或其他属性搜索任务

工作流API（5个工具）

• hubspot_list_工作流 -列出HubSpot中的所有自动化工作流程
• hubspot_get_工作流 -按ID获取特定工作流的详细信息
• hubspot_enroll_contact_in_工作流程 -将联系人（通过电子邮件）注册到工作流中
• hubspot_Unroll_contact_rom_workflow -从工作流中取消联系人登记
• hubspot_get_workflow_enrollments -获取当前已注册工作流的联系人

协会API（5个工具）

• hubspot_get_association_types -获取两个对象类型之间的所有可用关联类型
• hubspot_create_协会 -在两个HubSpot对象之间创建关联
• hubspot_get_协会 -获取HubSpot对象的所有关联
• hubspot_delete_协会 -删除两个对象之间的关联
• hubspot_batch_create_关联 -一次创建多个关联

所有者API（2个工具）

• hubspot_list_owners -列出帐户中的所有HubSpot所有者（用户）
• hubspot_get_owner -获取特定所有者的详细信息

API管道（4种工具）

• hubspot_get_pipelines -获取所有交易或门票渠道
• hubspot_get_pipeline -获取包括阶段在内的详细管道信息
• hubspot_get_pipeline_stages -获取特定管道的所有阶段
• hubspot_get_pipeline_stage -获取特定阶段的详细信息

属性API（3个工具）

• 轮毂_配件_特性 -获取HubSpot对象类型的所有可用属性
• 轮毂_配件_物业 -获取详细的房产信息，包括选项和验证
• hubspot_get_property_groups -获取HubSpot对象类型的所有属性组

发展

本地设置

1. 先决条件:

- Node.js v18+ - pnpm v9+

1. 克隆仓库:

git clone https://github.com/adeel0x01/hubspot-mcp-tools.git
cd hubspot-mcp-tools

1. 安装依赖项:

pnpm install

1. 构建项目:

pnpm run build

测试

pnpm run inspector  # Opens MCP Inspector

错误处理

服务器为常见问题提供详细的错误消息：

• 缺少API密钥：关于如何设置HUBSPOT_ACCESS_TOKEN的明确说明
• HubSpot API错误：包括调试的状态代码、消息和请求详细信息
• 验证错误：关于无效参数或缺少必填字段的有用消息

所有错误都会记录到stderr（对stdio传输是安全的），并以结构化格式返回给客户端。

重要说明

安全注意事项

• 永远不要承诺你的 .env 归档或公开您的HubSpot访问令牌
• 为了安全起见，访问令牌通过环境变量传递
• 使用HubSpot专用应用程序，只需最小的作用域

HubSpot访问令牌

要使用此服务器，您需要一个具有以下作用域的HubSpot专用应用访问令牌：

所需范围：

• crm.objects.contacts.read 和 crm.objects.contacts.write
• crm.objects.companies.read 和 crm.objects.companies.write
• crm.objects.deals.read 和 crm.objects.deals.write
• tickets （读写）
• crm.objects.owners.read
• crm.schemas.contacts.read
• crm.schemas.companies.read
• crm.schemas.deals.read
• crm.objects.notes.read 和 crm.objects.notes.write
• crm.objects.calls.read 和 crm.objects.calls.write
• crm.objects.emails.read 和 crm.objects.emails.write
• crm.objects.meetings.read 和 crm.objects.meetings.write
• crm.objects.tasks.read 和 crm.objects.tasks.write
• automation （读写，用于工作流管理）

创建私人应用程序：

1. 前往HubSpot设置>集成>私人应用
2. 点击“创建私人应用”
3. 添加上面列出的所需范围
4. 生成访问令牌
5. 复制令牌并将其用作 HUBSPOT_ACCESS_TOKEN

私人应用程序文档：https://developers.hubspot.com/docs/api/private-apps

速率限制

此服务器遵守HubSpot的API速率限制：

• 专业/企业：每10秒100个请求
• 批处理操作一次最多可以处理100条记录

贡献

欢迎投稿！请随时提交问题或拉取请求。

许可证

麻省理工学院