Bitrix24 MCP Server (NeedMoarr)

bitrix24-mcp

Однофайловый MCP для Битрикс24 на uv run: задачи с чек-листами, чаты, календарь, сделки CRM и ежедневный дайджест

MCP-сервер

Высокий риск

Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.

Почему такой уровень

  • Может создавать задачи, события календаря и отправлять сообщения от имени вебхука
  • Вебхук с расширенным набором прав хранится только в переменной окружения
  • Читает переписку в чатах и задачах
Все причины и проверки
Российский стек

needmoarr/bitrix24-mcp

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/needmoarr-bitrix24-mcp

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Собрано автоматически, проверьте перед установкой.

У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.

Выполните в терминале

claude mcp add --transport stdio --env 'BITRIX_WEBHOOK_URL=<ваш BITRIX_WEBHOOK_URL>' bitrix24-mcp -- uvx run server.py

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "bitrix24-mcp": {
      "command": "uvx",
      "args": [
        "run",
        "server.py"
      ],
      "env": {
        "BITRIX_WEBHOOK_URL": "<ваш BITRIX_WEBHOOK_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

BITRIX_WEBHOOK_URLсекрет, обязательная
URL входящего вебхука Bitrix24

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "bitrix24-mcp": {
      "command": "uvx",
      "args": [
        "run",
        "server.py"
      ],
      "env": {
        "BITRIX_WEBHOOK_URL": "<ваш BITRIX_WEBHOOK_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

BITRIX_WEBHOOK_URLсекрет, обязательная
URL входящего вебхука Bitrix24

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

code --add-mcp '{"name":"bitrix24-mcp","type":"stdio","command":"uvx","args":["run","server.py"],"env":{"BITRIX_WEBHOOK_URL":"<ваш BITRIX_WEBHOOK_URL>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "bitrix24-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "run",
        "server.py"
      ],
      "env": {
        "BITRIX_WEBHOOK_URL": "<ваш BITRIX_WEBHOOK_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

BITRIX_WEBHOOK_URLсекрет, обязательная
URL входящего вебхука Bitrix24

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add bitrix24-mcp --env 'BITRIX_WEBHOOK_URL=<ваш BITRIX_WEBHOOK_URL>' -- uvx run server.py

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.bitrix24-mcp]
command = "uvx"
args = ["run", "server.py"]
env = { BITRIX_WEBHOOK_URL = "<ваш BITRIX_WEBHOOK_URL>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

BITRIX_WEBHOOK_URLсекрет, обязательная
URL входящего вебхука Bitrix24

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

gemini mcp add -s user -e 'BITRIX_WEBHOOK_URL=<ваш BITRIX_WEBHOOK_URL>' bitrix24-mcp uvx run server.py

Или добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "bitrix24-mcp": {
      "command": "uvx",
      "args": [
        "run",
        "server.py"
      ],
      "env": {
        "BITRIX_WEBHOOK_URL": "<ваш BITRIX_WEBHOOK_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

BITRIX_WEBHOOK_URLсекрет, обязательная
URL входящего вебхука Bitrix24

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "bitrix24-mcp": {
      "command": "uvx",
      "args": [
        "run",
        "server.py"
      ],
      "env": {
        "BITRIX_WEBHOOK_URL": "<ваш BITRIX_WEBHOOK_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

BITRIX_WEBHOOK_URLсекрет, обязательная
URL входящего вебхука Bitrix24

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "bitrix24-mcp": {
      "command": "uvx",
      "args": [
        "run",
        "server.py"
      ],
      "env": {
        "BITRIX_WEBHOOK_URL": "<ваш BITRIX_WEBHOOK_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

BITRIX_WEBHOOK_URLсекрет, обязательная
URL входящего вебхука Bitrix24

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "bitrix24-mcp": {
      "command": "uvx",
      "args": [
        "run",
        "server.py"
      ],
      "env": {
        "BITRIX_WEBHOOK_URL": "<ваш BITRIX_WEBHOOK_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

BITRIX_WEBHOOK_URLсекрет, обязательная
URL входящего вебхука Bitrix24

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "bitrix24-mcp": {
      "type": "local",
      "command": [
        "uvx",
        "run",
        "server.py"
      ],
      "environment": {
        "BITRIX_WEBHOOK_URL": "<ваш BITRIX_WEBHOOK_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

BITRIX_WEBHOOK_URLсекрет, обязательная
URL входящего вебхука Bitrix24

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "bitrix24-mcp": {
      "command": "uvx",
      "args": [
        "run",
        "server.py"
      ],
      "env": {
        "BITRIX_WEBHOOK_URL": "<ваш BITRIX_WEBHOOK_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

BITRIX_WEBHOOK_URLсекрет, обязательная
URL входящего вебхука Bitrix24

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "bitrix24-mcp": {
      "command": "uvx",
      "args": [
        "run",
        "server.py"
      ],
      "env": {
        "BITRIX_WEBHOOK_URL": "<ваш BITRIX_WEBHOOK_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

BITRIX_WEBHOOK_URLсекрет, обязательная
URL входящего вебхука Bitrix24

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: uv

Сверено с репозиторием 26 сент. 2026, коммит 742bc35.

Текст для агента

Установи uv, скачай server.py из NeedMoarr/bitrix24-mcp и зарегистрируй его в Claude Code командой claude mcp add --scope user bitrix24 -e BITRIX_WEBHOOK_URL='<свой вебхук>' -- uv run <путь до server.py>.

Другие способы из описания автора
claude mcp add --scope user bitrix24 -e BITRIX_WEBHOOK_URL='https://<portal>.bitrix24.ru/rest/<user_id>/<token>/' -- uv run /path/to/server.py

Команда из README, путь до server.py и вебхук нужно заменить на свои.

Проверка безопасности

Как мы проверяем

Высокий рискВысокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.

  • Может создавать задачи, события календаря и отправлять сообщения от имени вебхука
  • Вебхук с расширенным набором прав хранится только в переменной окружения
  • Читает переписку в чатах и задачах

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер это один Python-файл server.py с заголовком PEP 723, который запускается командой uv run и сам подтягивает зависимости. Через входящий вебхук портала он дает больше пятнадцати инструментов: полный цикл задач с BB-кодом, чек-листами и комментариями из чата задачи, последние диалоги и отправку сообщений только по явной просьбе пользователя, поиск сотрудников и структуру компании, события календаря, сделки CRM, статистику звонков через telephony и сводный дайджест дня: просрочки, дедлайны недели, открытые задачи и непрочитанные чаты.

Для кого. Для тех, кто хочет один личный MCP-сервер, покрывающий задачи, чаты, календарь и сделки Битрикс24 сразу.

Подходит, если

  • Нужен дневной дайджест по просрочкам, дедлайнам и непрочитанным чатам
  • Нужны и задачи, и чаты, и календарь в одном сервере
  • Хочется запускать сервер через uv run без ручной установки зависимостей

Не подходит, если

  • Нужны тесты и стабильный публичный релиз
  • Нужна работа с несколькими порталами одновременно

Пример запроса к агенту

Дай дневной дайджест: что просрочено, какие дедлайны на этой неделе и что непрочитано в чатах

MCP

Транспорт
stdio
Авторизация
API-ключ

Переменные окружения

BITRIX_WEBHOOK_URL обязательная, секрет
Адрес входящего вебхука портала Битрикс24 с расширенными правами

Ограничения

Один файл без тестов и лицензии, README содержит команду регистрации сервера с личным путем автора на его компьютере, ее нужно переписать под свою систему. Статистика звонков через voximplant в README отмечена как возможно недоступная на конкретном портале автора. Токен передается только через переменную окружения, ротации нет.

Как отключить. Удалите сервер командой claude mcp remove bitrix24 в user scope или уберите блок из конфигурации клиента.

Частые вопросы

Нужно ли устанавливать зависимости вручную?

Нет, uv run сам ставит их по PEP 723-заголовку в начале server.py.

Сервер сам пишет сообщения сотрудникам?

README прямо требует вызывать chat_send только по явной просьбе пользователя, а не по инициативе агента.

MCP-серверы
Выбор редакции

MCP-сервер со справкой по нодам и шаблонам n8n: агент подбирает ноды, проверяет конфигурацию и при наличии API создает воркфлоу в вашем n8n

MCP-серверВысокий риск23 тыс.Звезды репозитория
Официальный

Официальный плагин Zapier MCP: агент получает доступ к действиям в тысячах приложений через подключенный аккаунт Zapier

ПлагинВысокий риск421Звезды репозитория

Каталог скиллов и плагинов для Claude и других агентов, плюс собственные скиллы автоматизации 78 SaaS-сервисов через Composio

СкиллВысокий риск75,8 тыс.Звезды репозитория

Плагин и каталог CLI для агентов: генерирует командный интерфейс к GUI-программам вроде GIMP и Blender и ставит готовые через CLI-Hub

ПлагинВысокий риск50,9 тыс.Звезды репозитория

Коротко о README

README на русском группирует больше пятнадцати инструментов по разделам: задачи, чаты и сообщения, остальное (сотрудники, группы, календарь, сделки, звонки, дайджест, профиль). Дан пример регистрации в Claude Code с uv run, список прав вебхука, расширенных 14 августа 2026 года, и пояснение, что комментарии задач на самом деле живут в чатах, а не в легаси-методе task.commentitem.getlist.

Foxx AIBitrix24 MCP Server (NeedMoarr)

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.