HubSpot MCP Server
2025.04.01
9
TypeScriptHubSpotCRMModel Context ProtocolMCPAI AssistantTypeScriptAPI IntegrationHubSpot APICRM IntegrationContact ManagementCompany ManagementEngagement TrackingAI Tools交流协作
HubSpot MCP Server 是一个基于 Model Context Protocol (MCP) 的服务实现，专为与 HubSpot CRM 无缝集成而设计。它允许 AI 助手直接与 HubSpot CRM 数据进行交互，执行创建和管理联系人、公司、获取活动历史等操作。该服务提供了简化的 CRM 操作、实时数据访问和安全认证等功能。
View on GitHub
Overview
基本能力
产品定位
HubSpot MCP Server 是一个专为 HubSpot CRM 设计的 MCP 服务，旨在通过 AI 助手简化 CRM 操作，提供实时数据访问和安全管理功能。
核心功能
- 创建和管理 HubSpot CRM 中的联系人和公司
- 获取公司活动历史和参与时间线
- 访问整个 HubSpot 实例的近期参与数据
- 获取最近活跃的公司和联系人列表
- 通过自然语言命令执行 CRM 操作
适用场景
- 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 开发者账户创建私有应用并复制生成的访问令牌。
- 如何提供访问令牌？ 可以通过环境变量或命令行参数提供。
- 如何实现 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 可用。