Работа с CLI HubSpot через ИИ-агента
Читайте и меняйте сделки, смотрите воронку, копируйте активности, получайте утреннюю сводку и API HubSpot.
Знайте, где стоит каждая сделка и что изменилось за ночь, не открывая HubSpot. hubspot приносит CRM аккаунта в ваш
терминал и к вашему ИИ-агенту: какие сделки стоят на стадии, какие задачи просрочены, и утреннюю сводку того, что
изменилось.
Каждая команда начинается с профиля, имени, которое вы дали аккаунту. sync копирует сделки с их контактами и
компаниями в локальное хранилище WireCat на вашем компьютере, и большинство команд чтения отвечает оттуда, в том
числе без интернета. Здесь считается, что вы уже вошли в профиль, как показывает
установка и подключение.
На этой странице:
- Сначала профиль
- Первая синхронизация
- Читайте свои сделки
- Меняйте сделки, контакты и компании
- Активности и что изменилось
- Вызов API
- Вывод для скриптов
- Агенты
Сначала профиль
Профиль это имя, которое вы выбираете для одного аккаунта. Оно стоит первым словом каждой команды, которая работает с аккаунтом:
hubspot work config showWCHUBSPOT_PROFILE=work делает то же самое для одного сеанса оболочки. Профиль никогда не подставляется сам, даже
если он единственный. Команда без профиля останавливается с кодом выхода 2 и перечисляет профили на этом компьютере.
hubspot work session status --check показывает, какой аккаунт читает профиль.
Первая синхронизация
sync копирует воронки, сделки и их контакты и компании в локальное хранилище. Ключ HubSpot принадлежит аккаунту, а
не человеку, поэтому копия охватывает весь аккаунт. После этого команды вроде deals list читают эту копию без
интернета:
hubspot work sync
hubspot work deals list status:openЗапустите sync снова, чтобы обновить копию: он спрашивает у HubSpot только то, что изменилось с прошлого раза. Так
копия остается свежей по таймеру:
hubspot work schedule command crm --every 1h -- syncЧитайте свои сделки
hubspot work deals list stage:"Contract sent"
hubspot work deals show deal:12
hubspot work pipelines listdeals list принимает условия вида поле:значение, например status:open или stage:"Contract sent", и
--format csv для таблицы. Ключ не называет пользователя, поэтому owner:me никого не находит. Возьмите id
ответственного из hubspot work users list и фильтруйте по нему, например owner:51234567. deals show показывает
одну сделку с ее стадией, суммой и людьми.
Лиды читаются так же через leads list в Sales Hub Professional или Enterprise.
Контакты, компании и ответственные читаются из аккаунта напрямую:
hubspot work people list "Anna"
hubspot work organizations show 9
hubspot work users listМеняйте сделки, контакты и компании
Для этого нужны scope ключа на запись (установка). Сначала запустите sync: стадия
или воронка называется так, как ее знает копия.
hubspot work deals create --title "Example kitchen" --amount 15000 --currency EUR --stage "Appointment scheduled"
hubspot work deals update deal:12 --close-date 2026-12-24 --field "Lead source=Trade fair"
hubspot work deals move deal:12 "Contract sent"
hubspot work deals close deal:12 lost --reason "Example: chose another supplier"
hubspot work deals delete deal:12
hubspot work people create --first-name Anna --last-name Example --email anna@example.com
hubspot work organizations update 9 --name "Example LLC"Каждое изменение сначала уходит в HubSpot, а копия сохраняет ответ HubSpot. close переносит сделку на стадию
выигрыша или проигрыша ее воронки. delete архивирует сделку в HubSpot, где ее можно восстановить в течение 90 дней,
и в терминале сначала спрашивает. Через MCP отвечать некому, поэтому агента останавливает только readonly или
deny (разрешения).
--dry-run показывает ключи разрешений, которые проверяет изменение, и ничего не отправляет.
У контакта одна почта и два номера, телефон и мобильный. У компании один номер и нет почты. --phone и --email
заменяют весь список, поэтому один --phone у контакта стирает его мобильный номер, а --name задает и имя, и
фамилию. Заметки, задачи,
лиды и контакты и компания сделки записываются через API.
Ключ принадлежит аккаунту, а не вам, поэтому назначение ответственного через --owner проверяет crm.assign-others,
а он стоит на deny, пока вы его не разрешите (разрешения). HubSpot не принимает ключ
идемпотентности: изменение,
которое закончилось outcome_unknown, могло пройти, поэтому посмотрите на запись, прежде чем отправить его снова.
Активности и что изменилось
Заметки, звонки, письма, встречи и задачи по умолчанию выключены. Чтобы их копировать, включите настройку активностей,
подставив id своего аккаунта вместо примера 12345678. session status показывает id как account.
hubspot work config set crm.hubspot:12345678.activities on
hubspot work sync
hubspot work activities list overdue:truechanges list показывает, какие изменения увидели синхронизации: созданные, перенесенные, выигранные и проигранные
сделки и добавленные контакты. Это расписание делает утреннюю сводку за последний день:
hubspot work changes list "at>=1d"
hubspot work schedule command crm-digest --at 08:30 -- changes list --format reportВызов API
hubspot work api list перечисляет все операции CRM API HubSpot версии 2026-03 с их действием и ключом разрешения.
Каждая операция это отдельная команда:
hubspot work api list
hubspot work api show deals-search
hubspot work api deals-search --body '{"after":"0","filterGroups":[],"limit":5,"properties":["dealname","amount"],"sorts":[]}'
hubspot work api deals-list --allКаждая операция проверяет свой ключ, api.<command>, поэтому permissions.api deny не пускает агента в API
напрямую. Запись в сделки, контакты или компании проверяет еще ключ своей команды (deals.update), другая запись
ключ .write своей группы (notes.write), а удаление ключ .delete. В терминале они сначала спрашивают. Через MCP
агента останавливает только readonly или deny.
--dry-run показывает ключи, ничего не отправляя:
hubspot work api notes-create --body-file note.json --dry-runhubspot work config set permissions.api denyВывод для скриптов
Каждая команда, кроме mcp serve на stdin и stdout, принимает --json и печатает одно значение JSON в stdout.
Ошибки приходят в JSON в stderr, с кодом, по которому можно ветвиться. Коды перечислены в
справочнике команд.
Агенты
hubspot skill install учит команды Claude Code, Codex, Gemini CLI и OpenClaw.
hubspot work mcp add claude-code --allow-writes подключает профиль к приложению, которое работает через MCP.
Остальное, включая ChatGPT и Claude в браузере, показывает страница MCP.