AI导哈

HubSpot CRM集成服务器

一个轻量级的基于REST的MCP服务器，用于将HubSpot CRM集成到自动化平台和AI代理中，支持通过简单的HTTP端点访问联系人、公司和交易信息。

  • by bajwa61
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 bajwa61/hubspot-mcp-server

使用说明

HubSpot MCP服务器

描述

一个轻量级的基于REST的MCP服务器，用于将HubSpot CRM集成到自动化平台和AI代理中。
支持通过简单的HTTP端点完全访问联系人、公司和交易，非常适合与n8n和其他无代码工具一起使用。

概述

此MCP服务器通过RESTful HTTP接口提供对HubSpot CRM的访问。它使助手、自动化工具或应用程序能够搜索、创建和更新联系人、公司和交易，而无需直接与各个HubSpot API端点交互。

该服务器与可以进行标准REST调用的基于代码和无代码平台兼容。

安装

  1. 克隆存储库：

    git clone https://github.com/bajwa61/hubspot-mcp-server
cd hubspot-mcp-server

  2. 安装依赖项：

    npm install

  3. 构建项目：

    npm run build

配置

此MCP服务器可用于编排环境和自动化工具，如n8n、Zapier或支持发出RESTful HTTP请求的任何平台。

环境变量

通过环境变量设置凭据：

变量 描述
HUBSPOT_ACCESS_TOKEN 具有CRM作用域的HubSpot私有应用令牌
PORT （可选）服务器端口（默认值：3000）
NODE_ENV （可选）环境模式： development 或 production

创建一个 .env 项目根目录中的文件：

HUBSPOT_ACCESS_TOKEN=pat-na1-your-token-here
PORT=3000
NODE_ENV=development

启动服务器

# Development
npm run start:dev

# Production
npm run start:prod

服务器将在上运行 http://localhost:3000 或您配置的端口。

可用的REST API端点

工具

方法 端点 描述
得到 /health 健康检查
得到 /tools 列出所有可用工具
职位 /tools/:toolName/call 调用特定工具

API调用示例

健康检查

curl http://localhost:3000/health

列出可用工具

curl http://localhost:3000/tools

搜索联系人

curl -X POST http://localhost:3000/tools/hubspot-search-objects/call \
  -H "Content-Type: application/json" \
  -d '{
    "object_type": "contacts",
    "limit": 10,
    "properties": ["firstname", "lastname", "email"]
  }'

创建公司

curl -X POST http://localhost:3000/tools/hubspot-batch-create-objects/call \
  -H "Content-Type: application/json" \
  -d '{
    "object_type": "companies",
    "inputs": [
      {
        "properties": {
          "name": "Example Corp",
          "industry": "Technology",
          "city": "San Francisco"
        }
      }
    ]
  }'

更新交易

curl -X POST http://localhost:3000/tools/hubspot-update-object/call \
  -H "Content-Type: application/json" \
  -d '{
    "object_type": "deals",
    "object_id": "123456789",
    "properties": {
      "amount": "75000",
      "dealstage": "contractsent"
    }
  }'

需求

  • Node.js 20.0.0或更高版本
  • HubSpot帐户，其私人应用程序包含CRM访问范围
  • 连接到HubSpot API的互联网

许可证

MIT许可证——见 LICENSE 文件以获取详细信息。

相关 MCP