
HubSpot MCP

2025.04.04
5
JavaScriptCRM 服务数据管理交流协作
HubSpot MCP 是一个基于 Model Context Protocol (MCP) 的实现,专门为 HubSpot API 提供标准化接口,用于访问和管理 CRM 数据。它提供了对 HubSpot CRM API 的完整覆盖,支持所有标准 CRM 对象(如公司、联系人、交易等),并包含高级关联管理、批量操作、高级搜索和过滤功能。
View on GitHub
Overview
基本能力
产品定位
HubSpot MCP 是一个为 HubSpot CRM 提供标准化接口的服务,旨在简化 CRM 数据的访问和管理。
核心功能
- 完整的 HubSpot CRM API 覆盖
- 支持所有标准 CRM 对象(公司、联系人、交易等)
- 高级关联管理(CRM Associations v4)
- 公司特定端点与属性验证
- 批量操作以提高数据管理效率
- 高级搜索和过滤功能
- 使用 Zod 进行类型安全的参数验证
适用场景
- 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
: 在单个请求中删除多个对象
常见问题解答
- 如何获取 API 密钥? 按照 HubSpot 开发者指南 获取访问令牌。
- 如何限制暴露给客户端应用程序的端点数量? 建议安装和设置 Heimdall。
使用教程
使用依赖
- 需要 Node.js 环境
- 需要 HubSpot 访问令牌
安装教程
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
调试方式
安装完成后,可以通过以下命令测试服务是否正常运行:
node /path/to/hubspot-mcp/index.js
确保环境变量 HUBSPOT_ACCESS_TOKEN
已正确设置。