# HubSpot

Локальный MCP-сервер для работы с HubSpot CRM: контакты, сделки, тикеты, задачи и файлы прямо из агента. Пригодится, если ведёте несколько аккаунтов сразу.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 13
- Автор: mindstone
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/mindstone/mcp-servers/tree/HEAD/connectors/hubspot
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/mcp/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`.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `HUBSPOT_CONFIG_DIR`, `HUBSPOT_ACCOUNT_EMAIL`, `MCP_WORKSPACE_PATH`, `HUBSPOT_CLIENT_ID`, `HUBSPOT_CLIENT_SECRET`, `HUBSPOT_SOURCE_LABEL`, `HUBSPOT_DISABLE_REFRESH`, `HUBSPOT_ALLOW_CLOUD_REFRESH`, `HUBSPOT_REQUEST_TIMEOUT_MS`, `HUBSPOT_REFRESH_LOCK_STALE_MS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.
- Работает с: HubSpot

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 сервера

## Когда брать
- найти компанию по названию и вытащить её ID
- записать заметку к карточке клиента после звонка
- поставить задачу с дедлайном и привязать к сделке
- разложить загруженные файлы по записям CRM
- вести несколько аккаунтов HubSpot из одного агента

## Примеры запросов агенту
- Найди в HubSpot компанию Acme Corp и запиши заметку о звонке с их CTO
- Создай задачу: связаться с Acme Corp во вторник, привяжи к компании
- Загрузи файл из рабочей папки и прикрепи его к записи сделки

## Похожие
- [HubSpot MCP](https://affpapa.org/nevibecode/mcp/hubspot-mcp.md) — MCP-сервер · ★ 63
- [hubspot-sales](https://affpapa.org/nevibecode/plugins/hubspot-sales.md) — плагин · ★ 4
- [bulk-operations](https://affpapa.org/nevibecode/skills/bulk-operations.md) — скилл · 1800 установок
- [closed-lost-revival](https://affpapa.org/nevibecode/skills/closed-lost-revival.md) — скилл · ★ 111
- [cleanup-lead-owners](https://affpapa.org/nevibecode/skills/cleanup-lead-owners.md) — скилл · ★ 78

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md