HubSpot — MCP-сервер для Claude Code: CRM-операции из чата
Локальный MCP-сервер для работы с HubSpot CRM: контакты, сделки, тикеты, задачи и файлы прямо из агента. Пригодится, если ведёте несколько аккаунтов сразу.
claude mcp add --env HUBSPOT_CONFIG_DIR=<HUBSPOT_CONFIG_DIR> --env HUBSPOT_ACCOUNT_EMAIL=<HUBSPOT_ACCOUNT_EMAIL> --env MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> --env HUBSPOT_CLIENT_ID=<HUBSPOT_CLIENT_ID> --env HUBSPOT_CLIENT_SECRET=<HUBSPOT_CLIENT_SECRET> --transport stdio hubspot -- npx -y @mindstone/mcp-server-hubspotЧто делает HubSpot
Сервер поднимается на вашей машине через npx -y @mindstone/mcp-server-hubspot и отдаёт агенту 106 инструментов: объекты CRM, связи между ними, маркетинговые списки, файлы, воркфлоу, переписки. Новые записи помечаются меткой источника, чтобы потом было видно, что их создал ИИ-агент. Загрузка файлов ограничена одной рабочей папкой на диске.
OAuth-поток запускает хост, а не сам сервер: он читает готовые токены из ${HUBSPOT_CONFIG_DIR}/credentials/*.token.json. Один процесс — один аккаунт HubSpot, поэтому для нескольких аккаунтов поднимайте несколько процессов с разным HUBSPOT_ACCOUNT_EMAIL. Нужны Node.js 20+ и npm.
Без HUBSPOT_CLIENT_ID и HUBSPOT_CLIENT_SECRET сервер всё равно стартует, но инструменты, которым нужен доступ к API, вернут структурированный ответ auth_required. Для файловых инструментов понадобится записываемая папка MCP_WORKSPACE_PATH.
Какие задачи решает
- найти компанию по названию и вытащить её ID
- записать заметку к карточке клиента после звонка
- поставить задачу с дедлайном и привязать к сделке
- разложить загруженные файлы по записям CRM
- вести несколько аккаунтов HubSpot из одного агента
Примеры запросов агенту
- Найди в HubSpot компанию Acme Corp и запиши заметку о звонке с их CTO
- Создай задачу: связаться с Acme Corp во вторник, привяжи к компании
- Загрузи файл из рабочей папки и прикрепи его к записи сделки
Как установить HubSpot
Командой платформы
claude mcp add --env HUBSPOT_CONFIG_DIR=<HUBSPOT_CONFIG_DIR> --env HUBSPOT_ACCOUNT_EMAIL=<HUBSPOT_ACCOUNT_EMAIL> --env MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> --env HUBSPOT_CLIENT_ID=<HUBSPOT_CLIENT_ID> --env HUBSPOT_CLIENT_SECRET=<HUBSPOT_CLIENT_SECRET> --transport stdio hubspot -- npx -y @mindstone/mcp-server-hubspotВместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Командой платформы
codex mcp add hubspot --env HUBSPOT_CONFIG_DIR=<HUBSPOT_CONFIG_DIR> --env HUBSPOT_ACCOUNT_EMAIL=<HUBSPOT_ACCOUNT_EMAIL> --env MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> --env HUBSPOT_CLIENT_ID=<HUBSPOT_CLIENT_ID> --env HUBSPOT_CLIENT_SECRET=<HUBSPOT_CLIENT_SECRET> -- npx -y @mindstone/mcp-server-hubspotВместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"hubspot": {
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-hubspot"
],
"env": {
"HUBSPOT_CONFIG_DIR": "<HUBSPOT_CONFIG_DIR>",
"HUBSPOT_ACCOUNT_EMAIL": "<HUBSPOT_ACCOUNT_EMAIL>",
"MCP_WORKSPACE_PATH": "<MCP_WORKSPACE_PATH>",
"HUBSPOT_CLIENT_ID": "<HUBSPOT_CLIENT_ID>",
"HUBSPOT_CLIENT_SECRET": "<HUBSPOT_CLIENT_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"hubspot": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-hubspot"
],
"env": {
"HUBSPOT_CONFIG_DIR": "<HUBSPOT_CONFIG_DIR>",
"HUBSPOT_ACCOUNT_EMAIL": "<HUBSPOT_ACCOUNT_EMAIL>",
"MCP_WORKSPACE_PATH": "<MCP_WORKSPACE_PATH>",
"HUBSPOT_CLIENT_ID": "<HUBSPOT_CLIENT_ID>",
"HUBSPOT_CLIENT_SECRET": "<HUBSPOT_CLIENT_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e HUBSPOT_CONFIG_DIR=<HUBSPOT_CONFIG_DIR> -e HUBSPOT_ACCOUNT_EMAIL=<HUBSPOT_ACCOUNT_EMAIL> -e MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> -e HUBSPOT_CLIENT_ID=<HUBSPOT_CLIENT_ID> -e HUBSPOT_CLIENT_SECRET=<HUBSPOT_CLIENT_SECRET> hubspot npx -y @mindstone/mcp-server-hubspotВместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о HubSpot
Как установить HubSpot в Claude Code?
Одной командой: `claude mcp add mcp-server-hubspot -e HUBSPOT_CONFIG_DIR=<HUBSPOT_CONFIG_DIR> -e HUBSPOT_ACCOUNT_EMAIL=<HUBSPOT_ACCOUNT_EMAIL> -e HUBSPOT_CLIENT_ID=<HUBSPOT_CLIENT_ID> -e HUBSPOT_CLIENT_SECRET=<HUBSPOT_CLIENT_SECRET> -- npx -y @mindstone/mcp-server-hubspot`. Подставьте свои значения вместо плейсхолдеров.
Что делает этот MCP-сервер?
Даёт агенту доступ к объектам HubSpot CRM: контактам, компаниям, сделкам, тикетам, лидам, задачам и заметкам, а также к свойствам, владельцам, маркетинговым спискам, воркфлоу и файлам. Всего 106 инструментов.
Почему инструменты возвращают auth_required?
Сервер работает с host-orchestrated OAuth и читает токены из файлов, которые пишет хост. Если учётные данные не подхватились, authenticate_hubspot_account вернёт ответ auth_required, и хост откроет OAuth-поток в браузере.
