Skip to main content
Glama
Yandex Tracker MCP

Yandex Tracker MCP

by rubevg

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_issue

  • search_issues

  • list_comments

  • list_queues

  • list_transitions

  • get_checklist

  • get_checklist_report

  • list_worklogs

  • get_issue_time_report

  • get_time_report

  • get_current_user

  • get_user

  • list_users

  • search_users

  • get_global_fields

  • get_queue_fields

  • get_statuses

  • get_issue_types

  • get_priorities

  • get_resolutions

Изменяющие данные:

  • create_issue

  • update_issue

  • add_comment

  • execute_transition

  • add_checklist_item

  • update_checklist_item

  • delete_checklist_item

  • add_worklog

  • update_worklog

  • delete_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-история и исходный код в этот репозиторий не переносились.

Лицензия

MIT

Available Tools

30 tools
add_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_itemA
Destructive

Удалить один пункт чек-листа. Необратимо изменяет задачу; подтвердите идентификатор пункта с пользователем.

Inputs: issue_id (required), checklist_item_id (required). Returns: result

delete_worklogA
Destructive

Удалить запись трудозатрат. Необратимо изменяет данные; подтвердите задачу и идентификатор записи с пользователем.

Inputs: issue_id (required), worklog_id (required). Returns: object

execute_transitionB
Destructive

Выполнить переход статуса задачи. Изменяет данные в Трекере; подтвердите целевой переход с пользователем.

Inputs: issue_id (required), transition_id (required), fields. Returns: object

get_checklistB
Read-only

Получить пункты чек-листа задачи вместе с их идентификаторами.

Inputs: issue_id (required). Returns: result

get_checklist_reportA
Read-only

Проанализировать чек-лист задачи: прогресс, открытые и просроченные пункты, разбивка по исполнителям. as_of задаётся как YYYY-MM-DD.

Inputs: issue_id (required), as_of. Returns: object

get_current_userA
Read-only

Получить пользователя, которому принадлежит текущий токен Трекера.

Inputs: no named parameters. Returns: object

get_global_fieldsA
Read-only

Получить все глобальные поля задач вместе со схемами и типами.

Inputs: no named parameters. Returns: result

get_issueB
Read-only

Получить задачу Яндекс Трекера по ключу, например TEST-123.

Inputs: issue_id (required), fields. Returns: object

get_issue_time_reportB
Read-only

Проанализировать трудозатраты одной задачи: план, факт, отклонение и разбивка по сотрудникам и дням. Даты задаются как YYYY-MM-DD.

Inputs: issue_id (required), date_to, date_from. Returns: object

get_issue_typesA
Read-only

Получить допустимые типы задач и их ключи.

Inputs: no named parameters. Returns: result

get_prioritiesA
Read-only

Получить уровни приоритета и ключи для создания или изменения задач.

Inputs: no named parameters. Returns: result

get_queue_fieldsB
Read-only

Получить поля очереди. При include_local_fields=true также возвращает локальные поля этой очереди.

Inputs: queue_id (required), include_local_fields. Returns: object

get_resolutionsA
Read-only

Получить доступные резолюции для закрытия задач.

Inputs: no named parameters. Returns: result

get_statusesA
Read-only

Получить статусы задач, настроенные в организации.

Inputs: no named parameters. Returns: result

get_time_reportC
Read-only

Построить сводный отчёт по задачам из запроса Tracker: итоги и разбивка по сотрудникам, задачам, очередям и дням. Даты задаются как YYYY-MM-DD.

Inputs: query (required), date_to, date_from, max_issues, +1 more. Returns: object

get_userC
Read-only

Получить пользователя организации по логину или UID.

Inputs: user_id (required). Returns: object

list_commentsC
Read-only

Получить комментарии задачи.

Inputs: issue_id (required). Returns: result

list_queuesC
Read-only

Получить доступные очереди Яндекс Трекера.

Inputs: page, per_page. Returns: result

list_transitionsB
Read-only

Получить доступные переходы статуса для задачи.

Inputs: issue_id (required). Returns: result

list_usersC
Read-only

Получить страницу пользователей организации.

Inputs: page, per_page. Returns: result

list_worklogsA
Read-only

Получить записи трудозатрат задачи. Автоматически загружает страницы, но возвращает не более 500 записей.

Inputs: issue_id (required), limit. Returns: result

search_issuesC
Read-only

Найти задачи на языке запросов Яндекс Трекера.

Inputs: query (required), page, fields, per_page. Returns: result

search_usersB
Read-only

Найти пользователей по логину, email, отображаемому имени или фамилии. Просматривает не более 1000 пользователей.

Inputs: query (required), limit. Returns: result

update_checklist_itemB
Destructive

Изменить один пункт чек-листа: текст, выполнение, исполнителя или срок. Изменяет задачу; покажите изменения пользователю перед вызовом.

Inputs: issue_id (required), checklist_item_id (required), text, checked, +5 more. Returns: result

update_issueB
Destructive

Обновить поля существующей задачи. Изменяет данные в Трекере; покажите изменения пользователю перед вызовом.

Inputs: fields (required), issue_id (required). Returns: object

update_worklogB
Destructive

Изменить запись трудозатрат. Изменяет данные в Трекере; покажите новые значения пользователю перед вызовом.

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

    B3.2/5.0

    Scored across 30 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables 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 npm
      52
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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