Yandex Tracker MCP
Supports Yandex Cloud organizations for Yandex Tracker access, including IAM authentication and TRACKER_CLOUD_ORG_ID configuration, enabling AI assistants to manage Tracker issues, comments, checklists, worklogs, queues, and reference data within a Yandex Cloud organization.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Yandex Tracker MCP покажи мои открытые задачи"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Yandex Tracker MCP
Независимый MCP-сервер на Python для работы AI-ассистентов с REST API v3 Яндекс Трекера.
Возможности
получение и поиск задач;
создание и обновление задач;
чтение и добавление комментариев;
получение очередей;
просмотр и выполнение переходов статуса;
полное управление пунктами чек-листа;
управление трудозатратами и отчёты по задаче, сотрудникам, очередям и периодам;
пользователи, поля очередей, статусы, типы задач, приоритеты и резолюции;
OAuth- и IAM-аутентификация;
поддержка организаций Яндекс 360 и Yandex Cloud.
Инструменты, изменяющие данные, явно требуют от MCP-клиента сначала показать планируемое изменение и получить подтверждение пользователя.
Related MCP server: Yandex Tracker MCP Server
Быстрый запуск
Требуются Python 3.11+ и uv.
cp .env.example .env
# Заполните .env, затем:
uv sync
uv run yandex-tracker-mcpИспользуйте ровно один способ аутентификации:
TRACKER_TOKEN— OAuth-токен;TRACKER_IAM_TOKEN— IAM-токен.
И ровно один идентификатор организации:
TRACKER_ORG_ID— организация Яндекс 360;TRACKER_CLOUD_ORG_ID— организация Yandex Cloud.
Подключение к Cursor
Добавьте сервер в .cursor/mcp.json нужного проекта:
{
"mcpServers": {
"yandex-tracker": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/Yandex-Tracker-MCP",
"run",
"yandex-tracker-mcp"
],
"env": {
"TRACKER_TOKEN": "${env:TRACKER_TOKEN}",
"TRACKER_ORG_ID": "${env:TRACKER_ORG_ID}"
}
}
}
}Для Yandex Cloud замените TRACKER_ORG_ID на TRACKER_CLOUD_ORG_ID.
Не сохраняйте токены непосредственно в git.
Инструменты
Read-only:
get_issuesearch_issueslist_commentslist_queueslist_transitionsget_checklistget_checklist_reportlist_worklogsget_issue_time_reportget_time_reportget_current_userget_userlist_userssearch_usersget_global_fieldsget_queue_fieldsget_statusesget_issue_typesget_prioritiesget_resolutions
Изменяющие данные:
create_issueupdate_issueadd_commentexecute_transitionadd_checklist_itemupdate_checklist_itemdelete_checklist_itemadd_worklogupdate_worklogdelete_worklog
Чек-листы
get_checklist возвращает идентификаторы пунктов, необходимые для изменения и
удаления. Пункты поддерживают текст, отметку выполнения, исполнителя и deadline.
Для снятия исполнителя или срока используйте clear_assignee или
clear_deadline в update_checklist_item.
get_checklist_report рассчитывает процент выполнения, показывает открытые и
просроченные пункты и группирует их по исполнителям.
Анализ времени
get_issue_time_report строит отчёт по одной задаче: первоначальная и текущая
оценка, сумма worklog-записей, отклонение и разбивка по сотрудникам и дням.
get_time_report принимает запрос на языке Трекера и может ограничить отчёт
датами date_from / date_to в формате YYYY-MM-DD. Например:
Покажи затраты команды по Queue: "BACKEND" с 2026-09-01 по 2026-09-30,
с разбивкой по сотрудникам и задачам.Трекер хранит worklog в ISO 8601 (PT1H30M). Сервер приводит все длительности
к минутам, считая рабочий день равным 8 часам, а рабочую неделю — 40 часам.
Один отчёт обрабатывает не более 200 задач и 500 worklog-записей на задачу;
при достижении лимита ответ содержит truncated: true.
Для записи времени используйте длительность ISO 8601, например PT1H30M.
add_worklog, update_worklog и delete_worklog изменяют данные и требуют
предварительного подтверждения пользователя.
Справочники
Перед созданием или изменением задачи MCP может получить допустимые значения
через get_issue_types, get_priorities, get_statuses, get_resolutions и
get_queue_fields. search_users ищет по логину, email или имени и
просматривает не более 1000 пользователей.
Разработка
uv sync --group dev
uv run ruff check .
uv run mypy
uv run pytestОфициальная документация
API base URL: https://api.tracker.yandex.net/v3.
Происхождение
Проект реализован с собственной историей и структурой на основе официальной
документации Яндекс Трекера и Model Context Protocol. В качестве архитектурного
референса изучался Apache-2.0 проект
aikts/yandex-tracker-mcp;
его git-история и исходный код в этот репозиторий не переносились.
Лицензия
Available Tools
30 toolsadd_checklist_itemA
Добавить пункт чек-листа. Изменяет задачу; покажите текст, исполнителя и срок пользователю перед вызовом.
Inputs: text (required), issue_id (required), checked, assignee, +2 more. Returns: result
add_commentA
Добавить комментарий к задаче. Изменяет данные в Трекере; покажите текст пользователю перед вызовом.
Inputs: text (required), issue_id (required), summonees. Returns: object
add_worklogB
Списать время на задачу. Изменяет данные в Трекере; покажите длительность, дату начала и комментарий пользователю перед вызовом.
Inputs: duration (required), issue_id (required), start, comment. Returns: object
create_issueA
Создать задачу. Изменяет данные в Трекере; перед вызовом подтвердите название и очередь с пользователем.
Inputs: queue (required), summary (required), fields, assignee, +3 more. Returns: object
delete_checklist_itemADestructive
Удалить один пункт чек-листа. Необратимо изменяет задачу; подтвердите идентификатор пункта с пользователем.
Inputs: issue_id (required), checklist_item_id (required). Returns: result
delete_worklogADestructive
Удалить запись трудозатрат. Необратимо изменяет данные; подтвердите задачу и идентификатор записи с пользователем.
Inputs: issue_id (required), worklog_id (required). Returns: object
execute_transitionBDestructive
Выполнить переход статуса задачи. Изменяет данные в Трекере; подтвердите целевой переход с пользователем.
Inputs: issue_id (required), transition_id (required), fields. Returns: object
get_checklistBRead-only
Получить пункты чек-листа задачи вместе с их идентификаторами.
Inputs: issue_id (required). Returns: result
get_checklist_reportARead-only
Проанализировать чек-лист задачи: прогресс, открытые и просроченные пункты, разбивка по исполнителям. as_of задаётся как YYYY-MM-DD.
Inputs: issue_id (required), as_of. Returns: object
get_current_userARead-only
Получить пользователя, которому принадлежит текущий токен Трекера.
Inputs: no named parameters. Returns: object
get_global_fieldsARead-only
Получить все глобальные поля задач вместе со схемами и типами.
Inputs: no named parameters. Returns: result
get_issueBRead-only
Получить задачу Яндекс Трекера по ключу, например TEST-123.
Inputs: issue_id (required), fields. Returns: object
get_issue_time_reportBRead-only
Проанализировать трудозатраты одной задачи: план, факт, отклонение и разбивка по сотрудникам и дням. Даты задаются как YYYY-MM-DD.
Inputs: issue_id (required), date_to, date_from. Returns: object
get_issue_typesARead-only
Получить допустимые типы задач и их ключи.
Inputs: no named parameters. Returns: result
get_prioritiesARead-only
Получить уровни приоритета и ключи для создания или изменения задач.
Inputs: no named parameters. Returns: result
get_queue_fieldsBRead-only
Получить поля очереди. При include_local_fields=true также возвращает локальные поля этой очереди.
Inputs: queue_id (required), include_local_fields. Returns: object
get_resolutionsARead-only
Получить доступные резолюции для закрытия задач.
Inputs: no named parameters. Returns: result
get_statusesARead-only
Получить статусы задач, настроенные в организации.
Inputs: no named parameters. Returns: result
get_time_reportCRead-only
Построить сводный отчёт по задачам из запроса Tracker: итоги и разбивка по сотрудникам, задачам, очередям и дням. Даты задаются как YYYY-MM-DD.
Inputs: query (required), date_to, date_from, max_issues, +1 more. Returns: object
get_userCRead-only
Получить пользователя организации по логину или UID.
Inputs: user_id (required). Returns: object
list_commentsCRead-only
Получить комментарии задачи.
Inputs: issue_id (required). Returns: result
list_queuesCRead-only
Получить доступные очереди Яндекс Трекера.
Inputs: page, per_page. Returns: result
list_transitionsBRead-only
Получить доступные переходы статуса для задачи.
Inputs: issue_id (required). Returns: result
list_usersCRead-only
Получить страницу пользователей организации.
Inputs: page, per_page. Returns: result
list_worklogsARead-only
Получить записи трудозатрат задачи. Автоматически загружает страницы, но возвращает не более 500 записей.
Inputs: issue_id (required), limit. Returns: result
search_issuesCRead-only
Найти задачи на языке запросов Яндекс Трекера.
Inputs: query (required), page, fields, per_page. Returns: result
search_usersBRead-only
Найти пользователей по логину, email, отображаемому имени или фамилии. Просматривает не более 1000 пользователей.
Inputs: query (required), limit. Returns: result
update_checklist_itemBDestructive
Изменить один пункт чек-листа: текст, выполнение, исполнителя или срок. Изменяет задачу; покажите изменения пользователю перед вызовом.
Inputs: issue_id (required), checklist_item_id (required), text, checked, +5 more. Returns: result
update_issueBDestructive
Обновить поля существующей задачи. Изменяет данные в Трекере; покажите изменения пользователю перед вызовом.
Inputs: fields (required), issue_id (required). Returns: object
update_worklogBDestructive
Изменить запись трудозатрат. Изменяет данные в Трекере; покажите новые значения пользователю перед вызовом.
Inputs: issue_id (required), worklog_id (required), start, comment, +1 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 30 tools
Most tools target distinct resource+action pairs (issues, comments, checklist, worklogs, transitions, users). Minor overlap exists among get_user/search_users/list_users and between get_issue_time_report/get_time_report, but descriptions clarify the single-vs-search vs single-issue-vs-summary boundaries well.
Every tool follows a consistent snake_case verb_noun pattern (get_issue, create_issue, add_comment, delete_worklog, list_transitions). Verb choice (get/list/search/add/update/delete/execute) is used semantically and predictably throughout.
With 30 tools this is heavier than the ideal 3-15 range, though the domain (issues, comments, checklist, worklogs, queues, fields, statuses, reports, transitions) is genuinely broad and most tools are distinct. Count sits borderline-heavy rather than clearly bloated.
Coverage is strong: issues (create/update/get/search), worklogs and checklist items (full CRUD), comments (list/add), plus metadata and reporting. Minor gaps remain—no comment update/delete and no issue delete—but core lifecycle workflows are covered.
Maintenance
Related MCP Connectors
Task manager your agent can fully operate: boards, tasks, sprints, roles, worklogs, day planner.
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Connects AI assistants to TrackingTime for querying time entries, projects, tasks, customers, and team data using natural language.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to interact with JetBrains YouTrack 2025.2 for managing issues, sprints, dependencies, time tracking, and knowledge base content. Supports CRUD operations, bulk commands, analytics with Gantt charts and critical path analysis, and covers ~80% of the YouTrack REST API.29 npm52-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Yandex.Tracker task management system through MCP protocol. Supports creating and managing issues, searching tasks, handling comments, managing projects and queues, and generating analytics reports.ISC
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Yandex Tracker through its API for managing tasks, comments, and attachments. It supports issue searching, status transitions, and metadata retrieval for automated project management.MIT
- FlicenseAqualityDmaintenanceExposes Yandex Tracker's REST API v3 as tools for LLM clients, enabling issue management and queue operations via natural language.21-