bitrix24-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| BITRIX24_WEBHOOK_URL | Yes | The inbound webhook URL for your Bitrix24 portal, e.g. https://your-portal.bitrix24.ru/rest/USER_ID/SECRET_CODE/ |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| tasks_listC | Получить список задач с фильтрацией и сортировкой |
| tasks_search_textA | READ-ONLY: найти текст в заголовках и описаниях задач локальной фильтрацией с постраничным обходом |
| tasks_search_commentsA | READ-ONLY: найти текст в комментариях по явно переданному ограниченному списку задач |
| tasks_myA | Мои задачи: объединить задачи, где пользователь исполнитель и где постановщик (с дедупом) |
| tasks_getA | Получить детальную информацию о задаче по ID. Для summary рекомендуется select с DESCRIPTION |
| tasks_addC | Создать новую задачу |
| tasks_updateB | Обновить задачу по ID |
| tasks_completeC | Завершить задачу |
| tasks_commentsB | Получить комментарии задачи |
| tasks_comment_addA | Добавить комментарий к задаче |
| disk_uploadA | Загрузить файл в Bitrix Drive: из локального пути или из base64-контента |
| task_attach_fileA | Прикрепить файл к существующей задаче: по file_id или через локальную загрузку/ base64 |
| project_briefA | Бриф проекта: стадии канбана по порядку до 'В процессе' включительно, с задачами каждой стадии |
| tasks_archiveA | WRITE: переместить завершённые задачи в финальную стадию канбана. Требует confirm=true. Сначала используйте tasks_archive_dry_run |
| tasks_archive_dry_runA | READ-ONLY preview: какие завершённые задачи проекта будут перемещены в финальную стадию. Ничего не пишет |
| tasks_completed_periodA | Завершённые задачи за период. Основной фильтр по CLOSED_DATE, fallback по CHANGED_DATE для задач в финальных стадиях канбана |
| multi_project_reportA | READ-ONLY: собрать единый отчёт по активной работе, тестированию и завершениям для нескольких проектов |
| tasks_new_periodB | Новые задачи за период по CREATED_DATE (для раздела «новые направления» в отчёте) |
| tasks_in_progressA | Задачи стадии 'В процессе' проекта. Шорткат: стадия находится автоматически по названию |
| tasks_staleA | READ-ONLY: задачи-долгожители — задачи на стадии дольше N дней (по createdDate) |
| tasks_overloadB | READ-ONLY: исполнители с перегрузкой — у кого больше N задач 'В процессе' по проекту (или нескольким) |
| tasks_by_stageC | Получить задачи конкретной канбан-стадии проекта (GROUP_ID + STAGE_ID) |
| project_stagesB | Получить стадии канбана проекта (group_id) в порядке по SORT |
| tasks_chat_messagesC | Получить сообщения из чата задачи |
| im_chat_messagesB | Получить сообщения из чата/канала/личного диалога; для доступных тредов добавляет thread |
| im_thread_messagesA | READ-ONLY: прочитать существующий тред (комментарии) сообщения канала; при недоступности im.v2 использует fallback-сканирование |
| im_thread_replyA | WRITE: отправить сообщение в уже существующий тред от имени владельца webhook; новый тред через REST не создаётся |
| im_message_commentsB | Получить комментарии к публикации канала из скрытого comment-чата |
| im_chat_findB | Найти доступные текущему пользователю чаты по названию |
| workgroup_chat_getB | Получить основной чат рабочей группы/проекта по group_id или названию группы |
| im_chat_messages_periodA | Получить сообщения диалога за диапазон дат, листая im.dialog.messages.get через FIRST_ID |
| im_chat_listA | Список последних чатов/каналов текущего пользователя |
| im_send_fileA | Отправить файл в чат/личный диалог: по локальному пути, base64 или существующему file_id |
| im_send_messageB | Отправить сообщение в чат или личный диалог |
| user_getA | Получить информацию о пользователе по ID |
| user_searchA | Поиск пользователей по имени или email |
| kb_listA | Список баз знаний портала (модуль Landing). По умолчанию возвращает и standalone-базы (TYPE=KNOWLEDGE), и привязанные к рабочим группам (TYPE=GROUP). Видны только базы, расшаренные пользователю, под которым выписан webhook. Требует право webhook 'landing'. |
| kb_sectionsA | Страницы и разделы базы знаний по её site_id (из kb_list). Возвращает плоский список с признаком раздела (is_folder) и родителем (parent_id) для построения дерева. Системные страницы (главная/поиск/сайдбар) по умолчанию скрыты. Требует право webhook 'landing'. |
| kb_page_contentA | Полный текст страницы базы знаний по её landing_id (из kb_sections). Собирает блоки страницы и склеивает их содержимое. format: 'markdown' (по умолчанию), 'text' или 'html'. Требует право webhook 'landing'. |
| kb_searchB | READ-ONLY: найти текст в заголовках и содержимом страниц Landing-баз знаний ограниченным обходом блоков |
| kb2_listA | Доступные пользователю базы знаний 2.0. Использует REST 3.0 и требует scope webhook 'note' и право пользователя на просмотр базы. |
| kb2_treeA | Дерево документов базы знаний 2.0 с сохранением parentId/children. Поле truncated=true означает, что Bitrix24 обрезал дерево. Требует scope 'note'. |
| kb2_documentA | Документ базы знаний 2.0 по ID, включая заголовок, Markdown и метаданные. Число из URL /note/document// является ID документа. Требует scope 'note'. |
| kb2_searchA | Поиск документов базы знаний 2.0 по заголовку и содержимому. Bitrix24 возвращает только первую страницу; при hasMore=true уточните запрос. Требует scope 'note'. |
| kb2_document_createA | WRITE: создать документ Базы знаний 2.0 через note.document.add. Сначала вызови с confirm=false и покажи preview пользователю. Передавать confirm=true разрешено ТОЛЬКО после явного подтверждения пользователем именно этого создания в текущем диалоге. Bitrix24 создаст документ только если у пользователя webhook есть право создания в указанной базе/родителе. |
| kb2_document_deleteA | WRITE: переместить документ Базы знаний 2.0 в корзину через note.document.delete. Сначала вызови с confirm=false, сохрани expected_title и expected_updated_at из preview и покажи пользователю. Передавать confirm=true разрешено ТОЛЬКО после явного подтверждения пользователем именно этого удаления в текущем диалоге и вместе с теми же expected_title/expected_updated_at. Bitrix24 переместит документ в корзину только если у пользователя webhook есть право удаления. |
| kb2_document_updateA | WRITE: обновить заголовок и/или Markdown документа Базы знаний 2.0. Сначала вызови с confirm=false, сохрани expected_updated_at из preview и покажи пользователю изменения. Передавать confirm=true разрешено ТОЛЬКО после явного подтверждения пользователем именно этих изменений в текущем диалоге и вместе с тем же expected_updated_at. Перед записью MCP повторно проверяет updatedAt и отменяет устаревшее изменение. Агент не должен подтверждать запись самостоятельно. Всегда используется overwrite=false. Требует scope 'note' и право «Редактирование» у пользователя webhook. |
| bitrix_callC | Вызвать любой метод Bitrix24 REST API напрямую |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 48 tools
Multiple tools have overlapping purposes: kb2_search/kb_search and kb2_list/kb_list differ only by KB generation; several task report tools (tasks_completed_period, tasks_new_period, tasks_in_progress, tasks_stale, tasks_overload) cover similar territory. Even with descriptions, agents may struggle to pick the correct specialized tool.
Naming conventions are inconsistent: some follow object_verb (tasks_add, user_get), some use object_noun (tasks_comments, project_brief), and others use prepositions/adjectives (tasks_in_progress, tasks_overload). The mix makes it hard to predict tool names.
48 tools is excessive for a single server, even for a comprehensive Bitrix24 integration. Many tools are specialized variants of task reports, and the overall count burdens the agent with too many choices.
Core workflows for tasks, knowledge bases, and messaging are covered well, but notable gaps exist: no task deletion, no task stage movement, no user management beyond search/get, and no project creation. The two KB modules create redundancy rather than filling missing functionality.