CRMHubSpot

HubSpot: MCP-сервер и CLI для CRM

Скопируйте сделки, контакты и компании HubSpot на компьютер, чтобы ИИ-агент читал их без интернета.

Знайте, где стоит каждая сделка и что поменялось в CRM за ночь, не открывая HubSpot. hubspot дает ИИ-агенту, которым вы уже пользуетесь, например Claude Code или Codex, копию ваших сделок, контактов и компаний HubSpot на вашем компьютере, и агент отвечает по этой копии, даже без интернета. Сделки он тоже создает, двигает и закрывает, в тех пределах, которые вы разрешите.

Спросите, какие сделки ждут на стадии «Contract sent» и на какую сумму, что сдвинулось со вчера или сколько сделок воронки Sales перешло на следующую стадию в этом месяце. Агент ответит сделкой, ее суммой и ответственным. Нужен один ключ для аккаунта, который суперадминистратор один раз создает в настройках HubSpot.

На этой странице:

  1. Что вы получаете
  2. О чем новичок не догадается
  3. Как это выглядит
  4. Почему hubspot
  5. Что он умеет
  6. Как это работает
  7. Начните за несколько минут
  8. Ограничения
  9. Найдите руководство под свою задачу

Что вы получаете

  • Ответ вместо поиска. Спросите о сделке или клиенте своими словами. Агент найдет сделку с ее стадией, суммой и людьми, прочитает все с вашего компьютера, и вам не придется щелкать по HubSpot.
  • Воронка одним взглядом. Сколько сделок стоит на каждой стадии и на какую сумму, сколько перешло дальше и какая доля выиграна.
  • Утро начинается с того, что изменилось. Вчерашние новые сделки, переходы между стадиями, выигрыши и проигрыши приходят короткой сводкой в выбранное вами время: уведомлением на рабочем столе или в Telegram и почту через tg или mail от WireCat.
  • Вся работа по сделке в одном месте. Ее заметки, звонки, письма, встречи и задачи, и задачи, которые просрочены.
  • Изменения по просьбе. Достаточно написать «Перенеси Example kitchen в Contract sent». Агент найдет стадию по названию, а вы можете заранее проверить, какие разрешения нужны для изменения.
  • CRM рядом с вашими чатами. Один поиск находит сделку рядом с сообщениями, письмами и встречами о ней, которые другие инструменты WireCat хранят на вашем компьютере.

О чем новичок не догадается

  • Ключ принадлежит аккаунту, а не вам. Сервисный ключ HubSpot, с которым входит hubspot, не называет пользователя. Поэтому hubspot копирует сделки всего аккаунта, а owner:me никого не находит: агент фильтрует по id ответственного из hubspot work users list.
  • Создайте сервисный ключ, а не приватное приложение. HubSpot перестал создавать новые приватные приложения 26 октября 2026 года. Токен приватного приложения, которое у вас уже есть, по-прежнему работает. Где нажимать, показывает установка.
  • Что можно менять, решают scope ключа. Без scope на запись ключ только читает, что бы ни говорили настройки hubspot. Scope, который вы не выбрали, ломает только команды, которым он нужен, и ошибка его называет.
  • work это имя, которое вы выбираете сами. Оно называет один аккаунт HubSpot и стоит первым словом каждой команды. Ни одна команда не выбирает аккаунт за вас.
  • Через MCP «ask» выполняется. MCP это способ, которым приложения вроде Claude Desktop вызывают инструмент, и там никто не сидит у терминала, чтобы ответить на вопрос. Поставьте записи, которые агенту делать нельзя, на «только чтение» или запрет до того, как подключите его.
  • Все приложения аккаунта делят один дневной лимит вызовов API. hubspot отвечает на большинство вопросов по своей копии и работает в спокойном темпе, поэтому тратит его мало. Когда лимит исчерпан, ошибка говорит, когда он вернется.

Как это выглядит

You:    What changed in the CRM since yesterday?
Agent:  (runs hubspot work changes list "at>=1d")
        · New deal "Example kitchen", 15 000 EUR, in Appointment scheduled
        · "Example office" moved to Closed won, 8 200 EUR
You:    Move Example kitchen to Contract sent.
Agent:  (runs hubspot work deals move deal:12 "Contract sent")
        Done. "Example kitchen" (deal 12) is in Contract sent now.

Почему hubspot

  • Копия ваших сделок на вашем компьютере. Из пяти инструментов в сравнении, включая собственный MCP-сервер HubSpot, ни у одного другого не описано чтение сделок без интернета. Следующая синхронизация берет только изменения.
  • Разрешение на каждое действие. Разрешить, спросить, только чтение или запрет, для каждой команды и для каждой операции API HubSpot. Передать запись другому ответственному нельзя, пока вы это не разрешите.
  • Записи можно проверить заранее. --dry-run ничего не отправляет и показывает, какие разрешения нужны записи. Запись, которая потеряла ответ, сама не отправляется снова, поэтому оборванное соединение не создаст вторую сделку.
  • Бережно к HubSpot. Не больше 4 запросов в секунду на аккаунт, а большинству ответов запрос вообще не нужен.
  • Ключ остается в связке ключей системы. Его не видно ни в выводе, ни в ошибках, ни в журналах.
  • Бесплатно и с открытым кодом. Apache 2.0.

Другой инструмент подойдет лучше, если вам нужен HubSpot в ChatGPT или Claude в браузере, без программ на вашем компьютере, со входом под вашим именем и с вашими правами в HubSpot (собственный MCP-сервер HubSpot).

Что он умеет

  • Сделки и лиды: списки по стадии, воронке, ответственному или дате, одна сделка с ее людьми, создание, изменение, перенос, закрытие с выигрышем или проигрышем, выгрузка списка в CSV для таблицы. Для лидов нужен Sales Hub Professional или Enterprise. Как пользоваться
  • Воронка: каждая стадия с числом сделок и суммой, сколько сделок до нее дошло и пошло дальше, и доля выигранных за выбранный период. Как пользоваться
  • Контакты, компании и ответственные: найти любого из них в аккаунте, создать и изменить контакты и компании. Как пользоваться
  • Что изменилось: созданные, перенесенные, выигранные и проигранные сделки, смена ответственного, добавленные и выполненные активности в выбранном окне времени, и сводка по расписанию. Как пользоваться
  • Активности: заметки, звонки, письма, встречи и задачи по вашим сделкам, когда вы их включите. Как пользоваться
  • Любая операция CRM API HubSpot: заметки, задачи, тикеты, связи и слияния, у каждой свое разрешение. Как пользоваться

Как это работает

  • Копия на вашем компьютере. sync кладет воронки, сделки и лиды с их контактами и компаниями в локальное хранилище WireCat, один файл на вашем компьютере, общий для всех инструментов WireCat. Списки, воронка и поиск читают его, в том числе без интернета.
  • Вход по ключу. Сервисный ключ или токен приватного приложения. Он хранится в связке ключей системы, а на компьютере без нее в закрытом файле. Установка
  • Сделан для агентов и скриптов. Навык учит команды Claude Code, Codex и Gemini CLI, а MCP отдает их приложениям вроде Claude Desktop. --json дает ответ в JSON, а ошибка приходит с кодом, по которому можно ветвиться. MCP
  • Что хранится и что уходит в сеть. Безопасность

Начните за несколько минут

Вставьте это своему агенту:

Запрос
Установи hubspot командой npm install -g @wirecat/hubspot-cli. Помоги мне создать сервисный ключ HubSpot и запустить hubspot work session start, затем синхронизируй и покажи мои открытые сделки.

Или в терминале:

npm install -g @wirecat/hubspot-cli
hubspot skill install                 # teaches Claude Code, Codex and Gemini CLI to use hubspot
hubspot work session start            # paste the service key when asked
hubspot work sync                     # copy your deals with their contacts and companies
hubspot work deals list status:open   # your open deals, read from the copy

Нужен Node.js 22.16 или более поздний 22.x, либо Node.js 24 или новее. Установка

Ограничения

  • Контакты, компании и ответственные каждый раз читаются из HubSpot, поэтому им нужен интернет. В копии есть контакты и компании ваших сделок.
  • Для лидов нужен Sales Hub Professional или Enterprise.
  • Тикеты, заметки и задачи записываются через api, а тикеты не копируются.
  • HubSpot не помечает повторную запись как повтор. Запись, ответ на которую потерялся, могла пройти, поэтому проверьте запись в HubSpot, прежде чем отправить ее снова.

Найдите руководство под свою задачу

ЗадачаРуководство
Установить и подключить аккаунтУстановка
Читать и менять сделки, сводка, APIКак пользоваться
Подключить приложение с MCPMCP
Решить, что агенту можно менятьРазрешения
Точная команда или параметрКоманды
Что-то не работаетЕсли что-то пошло не так
Чем hubspot отличается от других инструментов для HubSpotСравнение