HubSpot MCP

Реализация протокола контекста модели (MCP) для API HubSpot , предоставляющая стандартизированный интерфейс для доступа и управления данными CRM.

Функции

• Полный охват API HubSpot CRM

• Поддержка всех стандартных объектов CRM (компании, контакты, сделки и т. д.)

• Расширенное управление ассоциациями с помощью CRM Associations v4

• Конечные точки компании с проверкой свойств

• Пакетные операции для эффективного управления данными

• Расширенные возможности поиска и фильтрации

• Проверка параметров безопасности типов с помощью Zod

Related MCP server: HubSpot MCP Server

Предпосылки

Если у вас нет ключа API, следуйте инструкциям здесь, чтобы получить токен доступа. Поддержка OAuth запланирована как будущее улучшение.

Конфигурация клиента

Существует несколько вариантов настройки клиента MCP с сервером. Для настройки сервера на хосте/удалённом сервере используйте CLI Smithery с ключом API Smithery . Для локальной установки используйте npx или сборку из исходного кода. Каждый из этих вариантов поясняется ниже.

Удаленный сервер Smithery (рекомендуется)

Чтобы добавить удаленный сервер в config.json вашего клиента MCP, выполните следующую команду из Smithery CLI :

npx -y @smithery/cli install @shinzo-labs/hubspot-mcp

При появлении соответствующего запроса введите HUBSPOT_ACCESS_TOKEN .

Кузнечное дело SDK

Если вы разрабатываете собственное приложение-агент, вы можете использовать шаблонный код здесь .

Локальная установка NPX

Чтобы установить сервер локально с помощью npx , добавьте следующее в config.json вашего клиента MCP:

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

Сборка из исходного кода

1. Загрузить репозиторий:

git clone https://github.com/shinzo-labs/hubspot-mcp.git

2. Установить пакеты (внутри клонированного репозитория):

pnpm i

3. Добавьте следующее в config.json вашего клиента MCP:

{
  "mcpServers": {
    "hubspot": {
      "command": "node",
      "args": [
        "/path/to/hubspot-mcp/index.js"
      ],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "your-access-token-here"
      }
    }
  }
}

Переменные конфигурации

Поддерживаемые инструменты

Основные объекты CRM

Базовые операции с объектами

• crm_list_objects : список объектов CRM с дополнительной фильтрацией и разбиением на страницы

• crm_get_object : Получить один объект CRM по идентификатору

• crm_create_object : Создать новый объект CRM

• crm_update_object : обновить существующий объект CRM

• crm_delete_object : Удалить объект CRM

Поиск и пакетные операции

• crm_search_objects : Поиск объектов CRM с использованием расширенных фильтров

• crm_batch_create_objects : Создание нескольких объектов в одном запросе

• crm_batch_update_objects : Обновление нескольких объектов за один запрос

• crm_batch_delete_objects : Удаление нескольких объектов за один запрос

Управление записями CRM

Компании

• Основные операции:

  • crm_create_company : Создать новую компанию с проверенными свойствами

  • crm_update_company : Обновить существующую компанию

  • crm_get_company : Получить одну компанию по идентификатору

  • 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 : Получить один контакт по идентификатору

  • 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 : Получить один лид по идентификатору

  • 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_delete : Удалить участие

  • 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_delete : Удалить встречу

  • 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 v4

• Основные операции:

  • crm_list_association_types : Список доступных типов ассоциаций

  • crm_get_associations : Получить все ассоциации между объектами

  • crm_create_association : Создать ассоциацию

  • crm_delete_association : Удалить ассоциацию

• Пакетные операции:

  • crm_batch_create_associations : Создание нескольких ассоциаций

  • crm_batch_delete_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 : Создать продукт с заданными свойствами и вернуть копию объекта, включая идентификатор.

• products_read : Чтение объекта, идентифицированного по идентификатору

• products_update : Выполнить частичное обновление объекта, идентифицированного по ID. Свойства только для чтения и несуществующие свойства приведут к ошибке. Значения свойств можно очистить, передав пустую строку.

• products_archive : Переместить объект, идентифицированный по идентификатору, в корзину для переработки.

• products_list : Прочитать страницу продуктов. Управляйте тем, что возвращается, с помощью параметра запроса properties . after — это токен курсора постраничного просмотра последнего успешно прочитанного ресурса, который будет возвращен как свойство JSON paging.next.after постраничного ответа, содержащего больше результатов.

• products_search : Поиск продуктов

Пакетные операции:

• products_batch_create : Создать партию продуктов

• products_batch_read : Чтение партии продуктов по внутреннему идентификатору или уникальным значениям свойств. Извлечение записей по параметру idProperty для извлечения записей по пользовательскому уникальному свойству значения.

• products_batch_update : обновление партии продуктов по внутреннему идентификатору или уникальным значениям, указанным в параметре запроса idProperty .

• products_batch_archive : Архивировать партию продуктов по идентификатору

Внося вклад

Вклады приветствуются и поощряются! Пожалуйста, прочтите CONTRIBUTING.md для получения инструкций по вопросам, вкладам и контактной информации.