HubSpot MCP Server
2025.04.22
0
TypeScriptHubSpotCRMAI AssistantAPI Integration交流协作
HubSpot MCP Server 是一个基于 Model Context Protocol (MCP) 的服务实现，专为与 HubSpot CRM 无缝集成而设计。它允许 AI 助手直接与 HubSpot CRM 数据进行交互，执行各种 CRM 操作，如创建和管理联系人、公司，获取公司活动历史记录和最近的互动数据等。该服务提供了安全认证机制，并支持扩展设计，可以轻松添加更多的 HubSpot API 功能。
View on GitHub
Overview
基本能力
产品定位
HubSpot MCP Server 是一个用于 AI 助手与 HubSpot CRM 集成的中间件服务，旨在简化 CRM 操作并实现自然语言命令执行。
核心功能
- 创建和管理 HubSpot CRM 中的联系人和公司
- 获取公司活动历史和互动时间线
- 访问整个 HubSpot 实例的最近互动数据
- 获取最近活跃的公司和联系人列表
- 通过 AI 助手界面执行 CRM 操作
适用场景
- AI 助手需要访问和操作 CRM 数据的场景
- 需要通过自然语言命令执行 CRM 操作的场景
- 需要实时获取和更新 HubSpot 数据的场景
工具列表
- 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 开发者账户创建私有应用并获取访问令牌
- 如何提供访问令牌？ 可以通过环境变量或命令行参数提供
- 如何实现 SSE 服务器认证？ 使用 mcp-proxy-auth 包进行 API 密钥验证
使用教程
使用依赖
# 克隆仓库
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