HubSpot CRM数据下载服务

一个实现Model Context Protocol (MCP)的服务,提供从HubSpot CRM下载数据到本地JSON文件的功能。

  • by ajthinking
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 ajthinking/hubspot-download

使用说明

HubSpot下载MCP服务器

概述

一种模型上下文协议(MCP)服务器实现,为HubSpot CRM提供下载功能。CRM对象作为JSON文件下载到工作区数据目录。

有关模型上下文协议及其工作原理的更多信息,请参阅 Anthropic的MCP文档.

特性

服务器提供两个主要工具:

1.下载架构

将所有HubSpot对象(联系人、公司、交易和票证)的模式下载到 data/hubspot/schema.json.

2.下载对象

从HubSpot下载对象及其属性:

  • 联系人
  • 公司
  • 交易
  • 门票

每种对象类型都保存到其自己的JSON文件中(例如。, data/hubspot/contacts.json).

先决条件

  1. HubSpot访问令牌-在您的HubSpot帐户中创建一个私人应用程序:

    • 前往“设置”>“集成”>“私人应用”
    • 使用以下范围创建新应用程序:
      • crm.objects.contacts.read
      • crm.objects.companies.read
      • crm.objects.deals.read
      • crm.objects.tickets.read
    • 复制访问令牌
  2. 创建一个 .env 使用以下命令在工作区中创建文件:

HUBSPOT_ACCESS_TOKEN=your_token_here

IDE的使用

按如下方式注册MCP:

{
  "mcpServers": {
    "hubspot-crm-server": {
      "command": "npx",
      "args": [
        "tsx",
        "TODO"
      ]
    }
  }
}

下载了哪些属性?

服务器为每种对象类型下载以下默认属性:

联系人

  • 创建日期
  • hs最后修改日期
  • hs_object_id
  • 最后修改日期
  • 名字
  • 姓氏
  • 电子邮件

公司

  • 创建日期
  • hs最后修改日期
  • hs_object_id
  • 名字

交易

  • 创建日期
  • hs最后修改日期
  • hs_object_id
  • 交易名称
  • 数量
  • 管道
  • 交易阶段
  • 关闭

门票

  • 创建日期
  • hs最后修改日期
  • hs_object_id
  • 名字

此外,服务器还会下载您在HubSpot中定义的任何自定义属性。

许可证

该项目根据MIT许可证获得许可。