HubSpot MCP Server
2025.04.04
0
TypeScriptHubSpotCRMAI AssistantAPI Integration交流协作
HubSpot MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，专为与 HubSpot CRM 无缝集成而设计。它允许 AI 助手直接与 HubSpot 数据进行交互，实现联系人、公司的创建与管理，获取公司活动历史和参与时间线，以及访问最近的参与数据等功能。该服务器简化了 CRM 操作，通过自然语言命令即可完成常见任务，同时提供实时数据访问和安全认证。
View on GitHub
Overview
基本能力
产品定位
HubSpot MCP Server 是一个连接 AI 助手与 HubSpot CRM 的中间件，旨在通过 MCP 协议实现 CRM 数据的无缝交互。
核心功能
- 联系人管理：创建、更新和管理 HubSpot 联系人
- 公司管理：创建、更新和管理 HubSpot 公司
- 活动历史：获取公司详细的活动历史和参与时间线
- 近期参与数据：访问最近的 CRM 活动数据
- 实时数据访问：获取最新的 HubSpot 实例数据
- 安全认证：使用 HubSpot API 令牌进行安全认证
适用场景
- AI 助手与 HubSpot CRM 的集成
- 通过自然语言命令执行 CRM 操作
- 实时访问和更新 CRM 数据
- 自动化联系人管理和公司管理
工具列表
- hubspot_create_contact：创建新联系人
- hubspot_create_company：创建新公司
- hubspot_get_company_activity：获取公司活动历史
- hubspot_get_recent_engagements：获取近期参与数据
- hubspot_get_active_companies：获取最近活跃的公司
- hubspot_get_active_contacts：获取最近活跃的联系人
- hubspot_update_contact：更新联系人信息
- hubspot_update_company：更新公司信息
常见问题解答
- 如何获取 HubSpot API 访问令牌？ 通过 HubSpot 开发者账户创建私有应用并获取访问令牌。
- 如何提供访问令牌？ 可以通过环境变量或命令行参数提供。
- 如何扩展服务器功能？
在
HubSpotClient类中添加新方法，并在setupToolHandlers中注册新工具。
使用教程
使用依赖
# 克隆仓库
git clone https://github.com/lkm1developer/hubspot-mcp-server.git
cd hubspot-mcp-server
# 安装依赖
npm install
# 构建项目
npm run build
安装教程
- 获取 HubSpot API 访问令牌
- 提供访问令牌（环境变量或命令行参数）
- 启动服务器
# 启动服务器
npm start
# 或使用特定访问令牌
npm start -- --access-token=your-access-token
调试方式
# 运行 SSE 服务器
npx mcp-proxy-auth node dist/index.js
# SSE URL
localhost:8080/sse?apiKey=apikey