YaTracker Connector

Python library and MCP server for working with the Yandex Tracker API.

🚀 Quick Start

Option 1: Docker (Recommended)

The easiest way to use the MCP server:

# 1. Создайте .env файл
cp config/sample.env .env
# Отредактируйте .env и добавьте свои credentials

# 2. Запустите
docker-compose up -d

# Готово! MCP сервер работает на порту 8080

Docker Advantages:

• ✅ No absolute paths

• ✅ Works the same everywhere

• ✅ Easy to share with colleagues

• ✅ No conflicts with other projects

📖 More details: DOCKER.md

Option 2: Local Installation

# 1. Установите зависимости
pip install -r requirements.txt

# 2. Создайте .env
cp config/sample.env .env
# Добавьте YATRACKER_TOKEN и YATRACKER_ORG_ID

# 3. Используйте CLI
PYTHONPATH=src python3.11 -m scripts.cli issues list --queue CRM

📖 More details: QUICKSTART.md

Related MCP server: yandex-tracker-mcp

📚 Documentation

• QUICKSTART.md - Quick CLI command reference

• CLAUDE.md - Full instructions for working with the project

• DOCKER.md - Deployment via Docker

🔧 Features

CLI (Command Line Interface)

# Список задач
PYTHONPATH=src python3.11 -m scripts.cli issues list --queue CRM --limit 50

# Комментарии
PYTHONPATH=src python3.11 -m scripts.cli comments list CRM-19
PYTHONPATH=src python3.11 -m scripts.cli comments add CRM-19 "Текст"

# Переходы статусов
PYTHONPATH=src python3.11 -m scripts.cli transitions list CRM-19

# Вложения
PYTHONPATH=src python3.11 -m scripts.cli attachments download CRM-19

Python API

from yatracker_connector import (
    build_tracker_client,
    get_issue,
    add_comment,
    search_issues
)

client = build_tracker_client()
issue = get_issue(client, 'CRM-19')
add_comment(issue, 'Текст комментария')

MCP Server for Claude Code

Run via Docker and configure in .mcp.json:

{
  "mcpServers": {
    "yatracker": {
      "transport": "sse",
      "url": "http://localhost:8080/sse"
    }
  }
}

MCP Tools

Working with Issues

• yatracker_search_issues - search and list issues

• yatracker_get_issue - issue details

• yatracker_create_issue - create an issue/lead

• yatracker_update_issue - update fields

Comments

• yatracker_list_comments - list comments

• yatracker_add_comment - add a comment

• yatracker_add_comment_with_attachment - comment with a file

Transitions and Statuses

• yatracker_list_transitions - available transitions

• yatracker_execute_transition - execute a transition

Attachments

• yatracker_download_attachments - download attachments

• yatracker_attach_file - attach a file

Metadata

• yatracker_list_queues - list queues

• yatracker_list_queue_fields - queue fields

• yatracker_list_all_fields - all system fields

• yatracker_list_queue_issue_types - issue types

• yatracker_get_queue_workflows - business process/status graph

🤝 For the Team

Sharing the project with colleagues (Docker):

# 1. Коллега клонирует репозиторий
git clone <url>
cd "YaTracker Connector"

# 2. Создает свой .env
cp config/sample.env .env
# Добавляет свои credentials

# 3. Запускает
docker-compose up -d

That's it! No path settings, Python versions, or anything else.

🔐 Configuration

Create a .env file in the project root:

YATRACKER_TOKEN=your_oauth_token_here
YATRACKER_ORG_ID=your_organization_id
# опционально, если ведёшь учёт приложения: YATRACKER_OAUTH_CLIENT_ID=...

How to get credentials:

1. OAuth Token: [Yandex OAuth](https://oauth.yandex