HubSpot: MCP-сервер и CLI для CRM
Скопируйте сделки, контакты и компании HubSpot на компьютер, чтобы ИИ-агент читал их без интернета.
Знайте, где стоит каждая сделка и что поменялось в CRM за ночь, не открывая HubSpot. hubspot дает ИИ-агенту,
которым вы уже пользуетесь, например Claude Code или Codex, копию ваших сделок, контактов и компаний HubSpot на вашем
компьютере, и агент отвечает по этой копии, даже без интернета. Сделки он тоже создает, двигает и закрывает, в тех
пределах, которые вы разрешите.
Спросите, какие сделки ждут на стадии «Contract sent» и на какую сумму, что сдвинулось со вчера или сколько сделок воронки Sales перешло на следующую стадию в этом месяце. Агент ответит сделкой, ее суммой и ответственным. Нужен один ключ для аккаунта, который суперадминистратор один раз создает в настройках HubSpot.
На этой странице:
- Что вы получаете
- О чем новичок не догадается
- Как это выглядит
- Почему hubspot
- Что он умеет
- Как это работает
- Начните за несколько минут
- Ограничения
- Найдите руководство под свою задачу
Что вы получаете
- Ответ вместо поиска. Спросите о сделке или клиенте своими словами. Агент найдет сделку с ее стадией, суммой и людьми, прочитает все с вашего компьютера, и вам не придется щелкать по 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 | Как пользоваться |
| Подключить приложение с MCP | MCP |
| Решить, что агенту можно менять | Разрешения |
| Точная команда или параметр | Команды |
| Что-то не работает | Если что-то пошло не так |
| Чем hubspot отличается от других инструментов для HubSpot | Сравнение |