HubSpot MCP Server
A. 模型上下文协议（MCP） 服务器实现 集客营销 API，为访问和管理CRM数据提供标准化接口。
特性
- 全面覆盖HubSpot CRM API
- 支持所有标准CRM对象（公司、联系人、交易等）
- 使用CRM Associations v4进行高级关联管理
- 具有属性验证的公司特定端点
- 批处理操作，实现高效的数据管理
- 高级搜索和过滤功能
- 类型安全参数验证 萨德
先决条件
如果您没有API密钥，请按照以下步骤操作 这里 以获得访问令牌。OAuth支持计划作为未来的增强功能。
客户端配置
有几个选项可以用服务器配置MCP客户端。对于托管/远程服务器设置，请使用Smithery的CLI和 API密钥。对于本地安装，请使用 npx 或者从源代码构建。下文将逐一解释这些选项。
Smithery远程服务器（推荐）
将远程服务器添加到MCP客户端 config.json，从运行以下命令 Smithery CLI:
npx -y @smithery/cli install @shinzo-labs/hubspot-mcp输入你的 HUBSPOT_ACCESS_TOKEN 当提示时。
Smithery软件开发工具包
如果您正在开发自己的代理应用程序，则可以使用样板代码 这里.
NPX本地安装
使用以下命令在本地安装服务器 npx，将以下内容添加到您的MCP客户端 config.json:
{
"mcpServers": {
"hubspot": {
"command": "npx",
"args": [
"@shinzolabs/hubspot-mcp"
],
"env": {
"HUBSPOT_ACCESS_TOKEN": "your-access-token-here"
}
}
}
}从源代码构建
- 下载仓库：
git clone https://github.com/shinzo-labs/hubspot-mcp.git- 安装软件包（在克隆仓库内）：
pnpm i- 将以下内容添加到您的MCP客户端
config.json:
{
"mcpServers": {
"hubspot": {
"command": "node",
"args": [
"/path/to/hubspot-mcp/index.js"
],
"env": {
"HUBSPOT_ACCESS_TOKEN": "your-access-token-here"
}
}
}
}配置变量
| 变量 | 描述 | 必填项？ | 默认值 |
|---|---|---|---|
HUBSPOT_ACCESS_TOKEN | Hubspot应用程序的访问令牌 | 是 | |
PORT | 流式HTTP传输方法的端口 | 否 | 3000 |
TELEMETRY_ENABLED | 启用遥测 | 否 | true |
支持的工具
核心CRM对象
crm_list_objects：列出具有可选筛选和分页功能的CRM对象crm_get_object：按ID获取单个CRM对象crm_create_object：创建新的CRM对象crm_update_object：更新现有CRM对象crm_archive_object：存档（删除）CRM对象crm_search_objects：使用高级筛选器搜索CRM对象crm_batch_create_objects：在单个请求中创建多个对象crm_batch_read_objects：在单个请求中读取多个pl对象crm_batch_update_objects：在单个请求中更新多个对象crm_batch_archive_objects：在单个请求中存档（删除）多个对象
公司
crm_create_company：创建具有已验证属性的新公司crm_update_company：更新现有公司crm_get_company：通过ID获取单个公司crm_search_companies：使用特定筛选器搜索公司crm_batch_create_companies：在单个请求中创建多个公司crm_batch_update_companies：在单个请求中更新多个公司crm_get_company_properties：获取所有可用的公司财产crm_create_company_property：创建新的公司属性
联系人
crm_create_contact：使用已验证的属性创建新联系人crm_update_contact：更新现有联系人的信息crm_get_contact：通过ID获取单个联系人crm_search_contacts：使用特定筛选器搜索联系人crm_batch_create_contacts：在单个请求中创建多个联系人crm_batch_update_contacts：在单个请求中更新多个联系人crm_get_contact_properties：获取所有可用的联系人属性crm_create_contact_property：创建新的联系人属性
潜在客户
crm_create_lead：创建具有已验证属性的新潜在客户crm_update_lead：更新现有潜在客户的信息crm_get_lead：通过ID获取单个潜在客户crm_search_leads：使用特定筛选器搜索潜在客户crm_batch_create_leads：在单个请求中创建多个潜在客户crm_batch_update_leads：在单个请求中更新多个潜在客户crm_get_lead_properties：获取所有可用的潜在客户属性crm_create_lead_property：创建新的潜在客户属性
敬业度管理
engagement_details_get：获取特定约定的详细信息engagement_details_create：创建新的约定engagement_details_update：更新现有约定engagement_details_archive：存档（删除）预约engagement_details_list：列出所有具有筛选功能的活动engagement_details_get_associated：获取相关约定
呼叫
calls_create：创建新的通话记录calls_get：获取通话详细信息calls_update：更新通话记录calls_archive：将通话存档calls_list：列出所有呼叫calls_search：搜索呼叫calls_batch_create：创建多个呼叫calls_batch_read：读取多个呼叫calls_batch_update：更新多个呼叫calls_batch_archive：存档多个通话
电子邮件
emails_create：创建新的电子邮件记录emails_get：获取电子邮件详细信息emails_update：更新电子邮件emails_archive：存档电子邮件emails_list：列出所有电子邮件emails_search：搜索电子邮件emails_batch_create：创建多封电子邮件emails_batch_read：阅读多封电子邮件emails_batch_update：更新多封电子邮件emails_batch_archive：存档多封电子邮件
会议
meetings_create：创建新会议meetings_get：获取会议详细信息meetings_update：更新会议meetings_archive：存档（删除）会议meetings_list：列出所有会议meetings_search：搜索会议meetings_batch_create：创建多个会议meetings_batch_update：更新多个会议meetings_batch_archive：存档多个会议
备注
notes_create：创建新笔记notes_get：获取笔记详细信息notes_update：更新注释notes_archive：存档笔记notes_list：列出所有注释notes_search：搜索笔记notes_batch_create：创建多个笔记notes_batch_read：阅读多个笔记notes_batch_update：更新多个笔记notes_batch_archive：存档多个笔记
任务
tasks_create：创建新任务tasks_get：获取任务详细信息tasks_update：更新任务tasks_archive：存档任务tasks_list：列出所有任务tasks_search：搜索任务tasks_batch_create：创建多个任务tasks_batch_read：阅读多个任务tasks_batch_update：更新多个任务tasks_batch_archive：存档多个任务
协会和关系
crm_list_association_types：列出可用的关联类型crm_get_associations：获取对象之间的所有关联crm_create_association：创建关联crm_archive_association：存档（删除）关联crm_batch_create_associations：创建多个关联crm_batch_archive_associations：存档（删除）多个关联
沟通偏好
communications_get_preferences：获取联系人首选项communications_update_preferences：更新联系人首选项communications_unsubscribe_contact：全局取消订阅communications_subscribe_contact：全球订阅communications_get_subscription_definitions：获取订阅定义communications_get_subscription_status：获取多个联系人的状态communications_update_subscription_status：更新多个联系人的状态
产品
products_create：使用给定的属性创建产品，并返回对象的副本，包括ID。products_read：读取由ID标识的对象products_update：对ID标识的对象执行部分更新。只读和不存在的属性将导致错误。可以通过传递空字符串来清除属性值。products_archive：将ID标识的对象移至回收箱。products_list：阅读一页产品。通过控制返回的内容properties查询参数。after最后一个成功读取的资源的分页游标令牌是否将作为paging.next.after包含更多结果的分页响应的JSON属性。products_search：搜索产品products_batch_create：创建一批产品products_batch_read：通过内部ID或唯一属性值读取一批产品。按以下方式检索记录idProperty参数，用于通过自定义唯一值属性检索记录。products_batch_update：通过内部ID或由指定的唯一值更新一批产品idProperty查询参数。products_batch_archive：按ID存档一批产品
贡献
欢迎和鼓励捐款！请阅读 贡献.md 有关问题、贡献和联系信息的指导方针。
数据收集和隐私
Shinzo Labs从该服务器收集有限的匿名遥测数据，以帮助改进我们的产品和服务。在此过程中，不会收集任何个人身份信息。请查看 隐私政策 有关收集的数据类型以及如何选择退出此遥测的更多详细信息。
许可证
麻省理工学院