HubSpot MCP Server

HubSpot MCP 服务

HubSpot 的模型上下文协议（MCP）服务实现，为与 HubSpot API 交互提供标准化接口。

概述

此软件包实现了一个 MCP 服务，充当应用程序与 HubSpot API 之间的桥梁。它通过模型上下文协议，提供与 HubSpot 服务交互的标准化方式。

使用示例

想知道 AI 如何改变你的 HubSpot 工作流吗？看看这些真实场景如何通过简单的对话变为现实：

💡 销售与项目管理

“我刚刚和 TechCorp 的 Sarah 开了一次很棒的会，讨论了他们的云迁移项目。创建一笔新的 25 万美元交易，将其关联到他们的公司记录，并安排下周与他们的 CTO 进行一次跟进电话，讨论实施时间表。”

🚀 客户入驻

“我们最大的客户 Enterprise Solutions 正在扩充团队。为他们新任 CTO 创建一个新联系人，将其关联到‘数字化转型’项目，并安排接下来两周与我们的技术团队进行一系列入驻会议。”

⚡ 项目交接

“‘AI 集成’项目即将进入最后阶段。更新交易状态，为交接流程创建新的支持工单，并安排下个月与客户团队进行一次培训，确保包含他们 IT 部门的所有相关联系人。”

用法

作为命令行工具运行

该服务通过 stdio 运行，可用作命令行工具：

hubspot-mcp-server

与 Claude Desktop 集成

若要将此服务与 Claude Desktop 配合使用，请将以下配置添加到你的 claude_desktop_config.json 中：

{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": [
        "-y",
        "@naoraideas/hubspot-mcp-server"
      ],
      "env": {
        "HUBSPOT_API_KEY": "your_hubspot_api_key_here"
      }
    }
  }
}

安装

npm install @NaorAIdeas/hubspot-mcp-server

前置条件

• Node.js（版本 14 或更高）——从官方网站下载并安装
• HubSpot API 密钥（个人访问令牌）

配置

获取 HubSpot API 密钥

要开始使用 HubSpot MCP 服务，你需要获取 API 密钥。以下是详细指南：

1. 登录 HubSpot 账号

   • 访问 HubSpot 网站 并登录你的账号

2. 前往私有应用

   • 前往 Settings > Account Setup > Integrations > Private Apps
   • 如果没有看到此选项，请确认你拥有必要的权限

3. 创建新的私有应用

   • 点击“Create a private app”
   • 为应用取一个描述性名称（例如，“HubSpot MCP Server”）
   • 添加应用用途说明

4. 配置权限范围

   • 选择以下权限范围（最低要求）：
     • crm.objects.contacts.read
     • crm.objects.contacts.write
     • crm.objects.companies.read
     • crm.objects.companies.write
     • crm.objects.deals.read
     • crm.objects.deals.write
     • crm.objects.custom.read
     • crm.objects.custom.write
     • crm.associations.read
     • crm.associations.write
     • timeline.read
     • timeline.write

5. 保存并获取 API 密钥

   • 点击“Create app”
   • 立即复制生成的访问令牌
   • 妥善保存，因为它只会显示一次

可用工具

联系人管理

• “我接到来自 (415) 555-0123 的电话，这是谁？”
• “将 John Smith 在 Acme Corp 的职位更新为销售副总裁”
• “帮我查找 TechStart Inc 的 Emma Wilson 的电子邮箱”

公司管理

• “显示旧金山地区的所有公司”
• “为 IT 行业的‘CloudTech Solutions’创建一条新公司记录”
• “将 Microsoft 的年收入更新为 2000 亿美元”

交易管理

• “‘Enterprise Cloud Migration’交易的状态是什么？”
• “为‘AI Integration Project’创建一笔价值 15 万美元的新交易”
• “将‘Digital Transformation’交易移至‘Contract Sent’阶段”

自定义对象

• “显示 ‘Product Development’ 管道中的所有活跃项目”
• “为 ‘Server Downtime’ 问题创建一张新的支持工单”
• “将 ‘Mobile App Launch’ 项目的优先级更新为 High”

关联

• “哪些联系人与 ‘Enterprise Solutions’ 公司相关联？”
• “将 Sarah Johnson 关联到 ‘Cloud Migration’ 项目”
• “移除 Mark Davis 与 ‘Legacy System’ 项目之间的关联”

时间线事件

• “显示本月与 Google 安排的所有会议”
• “为下周二创建一次与 Amazon 的新跟进电话”
• “更新昨天与 Microsoft 举行的产品演示的描述”

开发

环境设置

在项目根目录中创建一个 .env 文件，并添加以下内容：

HUBSPOT_API_KEY=your_hubspot_api_key_here

构建项目

npm run build

开发模式

若要以监视模式运行项目：

npm run watch

依赖项

• @hubspot/api-client：HubSpot API 客户端
• @modelcontextprotocol/sdk：Model Context Protocol SDK
• dotenv：环境变量管理
• zod：架构验证

许可证

本项目采用 MIT License 许可。

免责声明

本软件按“原样”提供，不提供任何明示或默示的保证，包括但不限于适销性、特定用途适用性和不侵权保证。在任何情况下，作者或版权持有人均不对因本软件或使用本软件而产生、引起或与之相关的任何索赔、损害或其他责任负责，无论是合同诉讼、侵权行为还是其他诉讼。

作者

Naor Hemed
AI 集成专家与软件工程师
热衷于构建能够变革业务工作流的智能系统。
欢迎联系我们，一起探索 AI 如何革新您的 HubSpot 使用体验！

GitHub | LinkedIn | 电子邮件

贡献

本项目倾注了 ❤️，旨在通过 AI 让更多人便捷地使用 HubSpot。
如果您想参与贡献、有任何问题，或者只是想聊聊 AI 驱动的工作流，欢迎联系我们！