AI导哈

CRM管理协议服务器

一个为AI助手提供HubSpot CRM全面访问权限的模型上下文协议服务器，可直接从兼容客户端管理联系人、公司、交易和流水线。

  • by cloud9-labs
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 cloud9-labs/mcp-hubspot

使用说明

HubSpot CRM MCP服务器

一种模型上下文协议（MCP）服务器，为AI助手提供对HubSpot CRM的完全访问权限。直接从Claude、Cursor或任何兼容MCP的客户端管理联系人、公司、交易、管道和关联。

特性

  • 联系人管理 -创建、读取、更新、搜索和列出联系人
  • 公司管理层 -创建、阅读和搜索公司
  • 交易管理 -创建、读取、更新和列出与管道跟踪相关的事务
  • 管道接入 -检索交易管道和阶段配置
  • 对象关联 -将联系人链接到公司，将交易链接到联系人等。
  • 内置速率限制 -自动节流（100个请求/10s），重试429次
  • 基于光标的分页 -大型数据集的高效数据检索

可用工具（14）

工具 说明
hubspot_create_contact 创建新联系人
hubspot_get_contact 通过ID或电子邮件联系
hubspot_update_contact 更新联系人属性
hubspot_search_contacts 使用筛选器搜索联系人
hubspot_list_contacts 按页码列出联系人
hubspot_create_company 创建新公司
hubspot_get_company 按ID获取公司
hubspot_search_companies 按名称/域名搜索公司
hubspot_create_deal 创建新交易
hubspot_get_deal 通过ID获取交易
hubspot_update_deal 更新交易属性
hubspot_list_deals 列表处理分页
hubspot_get_pipelines 获取所有交易渠道和阶段
hubspot_create_association 将CRM对象关联在一起

快速开始

npx @cloud9-labs/mcp-hubspot

先决条件

所需HubSpot范围

您的私人应用程序需要以下作用域：

  • crm.objects.contacts.read / crm.objects.contacts.write
  • crm.objects.companies.read / crm.objects.companies.write
  • crm.objects.deals.read / crm.objects.deals.write

安装

通过npm（推荐）

npm install @cloud9-labs/mcp-hubspot

来源

git clone https://github.com/cloud9-labs/mcp-hubspot.git
cd mcp-hubspot
npm install
npm run build

配置

克劳德桌面

增添 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": ["-y", "@cloud9-labs/mcp-hubspot"],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "your-access-token-here"
      }
    }
  }
}

光标

增添 .cursor/mcp.json:

{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": ["-y", "@cloud9-labs/mcp-hubspot"],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "your-access-token-here"
      }
    }
  }
}

使用示例

连接后，您可以询问您的AI助手：

  • “为John Smith创建联系人john@example.com"
  • “搜索Acme Corp的所有联系人”
  • “以50000美元的价格创建一项名为‘企业许可证’的交易”
  • “向我展示所有交易管道及其阶段”
  • “将联系人123与456公司联系”
  • “列出我们正在进行的最后20笔交易”

搜索筛选

这 hubspot_search_contacts 该工具支持高级过滤：

Operators: EQ, NEQ, LT, LTE, GT, GTE, BETWEEN, IN, NOT_IN,
           HAS_PROPERTY, NOT_HAS_PROPERTY, CONTAINS_TOKEN, NOT_CONTAINS_TOKEN

示例：搜索生命周期阶段等于“潜在客户”的联系人：

{
  "query": "",
  "filters": [
    {
      "propertyName": "lifecyclestage",
      "operator": "EQ",
      "value": "lead"
    }
  ]
}

构建人工智能销售自动化系统？

此MCP服务器是用于AI驱动的销售自动化的开源工具包的一部分。我们正在构建MCP服务器，连接您的整个销售堆栈——CRM、电子邮件、日程安排、潜在客户评分等。

关注我们的进展并获取更新：

许可证

麻省理工学院

相关 MCP