ya-tracker-mcp

ya-tracker-mcp

MCP server for Yandex Tracker API. Provides 146 tools for managing issues, projects, boards, sprints, worklog and more through the Model Context Protocol.

Built with FastMCP and YaTrackerApi.

Quick Start

Claude Code

claude mcp add ya-tracker \
  -e YA_TRACKER_TOKEN=your-oauth-token \
  -e YA_TRACKER_ORG_ID=your-org-id \
  -- uvx ya-tracker-mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "ya-tracker": {
      "command": "uvx",
      "args": ["ya-tracker-mcp"],
      "env": {
        "YA_TRACKER_TOKEN": "your-oauth-token",
        "YA_TRACKER_ORG_ID": "your-org-id"
      }
    }
  }
}

Cursor / Windsurf

Add to MCP settings:

{
  "ya-tracker": {
    "command": "uvx",
    "args": ["ya-tracker-mcp"],
    "env": {
      "YA_TRACKER_TOKEN": "your-oauth-token",
      "YA_TRACKER_ORG_ID": "your-org-id"
    }
  }
}

Authentication

You need an OAuth token and organization ID:

1. OAuth token - get at oauth.yandex.ru with Tracker access
2. Organization ID - find in Tracker admin settings or via API GET /v3/myself

Tools (146)

Issues (7)

| Tool | Description | |------|-------------| | create_issue | Create issue (supports fields in response) | | get_issue | Get issue details (supports fields and ["all"]) | | update_issue | Update issue fields (supports fields in response) | | search_issues | Search with query language or filters (supports fields) | | count_issues | Count matching issues | | move_issue | Move to another queue (supports fields in response) | | issue_changelog | Get issue change history (filter by field) |

Comments (4)

| Tool | Description | |------|-------------| | add_comment | Add comment (supports fields) | | list_comments | List issue comments (supports fields) | | update_comment | Update comment text (supports fields) | | delete_comment | Delete comment |

Status Transitions (2)

| Tool | Description | |------|-------------| | list_transitions | List available transitions | | transition_issue | Execute status transition |

Links (3)

| Tool | Description | |------|-------------| | link_issues | Create link (relates, depends on, subtask, epic...) | | list_links | List issue links | | delete_link | Delete link |

Entities — Projects / Portfolios / Goals (23)

| Tool | Description | |------|-------------| | create_entity | Create project, portfolio, or goal (supports fields) | | get_entity | Get entity with fields (supports ["all"]) | | update_entity | Update entity (supports fields) | | delete_entity | Delete entity | | search_entities | Search entities (supports fields) | | entity_changelog | Get entity change history | | update_key_results | Update goal key results | | update_entity_metrics | Update entity metrics | | list_entity_comments | List entity comments (supports fields) | | add_entity_comment | Add comment to entity | | update_entity_comment | Update entity comment | | delete_entity_comment | Delete entity comment | | list_entity_links | List entity links | | create_entity_link | Create link between entities | | delete_entity_link | Delete entity link | | list_entity_attachments | List entity attachments | | delete_entity_attachment | Delete entity attachment | | add_entity_checklist_item | Add checklist item to entity | | update_entity_checklist_item | Update entity checklist item | | delete_entity_checklist_item | Delete entity checklist item | | bulk_update_entities | Bulk update entities | | get_entity_settings | Get entity access settings | | update_entity_settings | Update entity access settings |

Boards & Sprints (12)

| Tool | Description | |------|-------------| | list_boards | All boards (cached, supports fields) | | get_board | Board details | | create_board | Create board (invalidates cache) | | update_board | Update board settings (invalidates cache) | | delete_board | Delete board (invalidates cache) | | list_board_columns | Board columns with statuses | | create_board_column | Create column | | update_board_column | Update column | | delete_board_column | Delete column | | list_sprints | Board sprints (cached, supports fields) | | get_sprint | Sprint details | | create_sprint | Create sprint (invalidates cache) |

Worklog (5)

| Tool | Description | |------|-------------| | add_worklog | Log time (supports fields) | | list_worklog | List worklog entries (supports fields) | | update_worklog | Update entry (supports fields) | | delete_worklog | Delete entry | | search_worklog | Search worklog entries (supports fields) |

Checklists (5)

| Tool | Description | |------|-------------| | list_checklist | List checklist items | | add_checklist_item | Add item | | update_checklist_item | Update item (text, checked, assignee) | | delete_checklist_item | Delete item | | delete_checklist | Delete entire checklist |

Attachments (2)

| Tool | Description | |------|-------------| | list_attachments | List attachments | | delete_attachment | Delete attachment |

Queues (10)

| Tool | Description | |------|-------------| | list_queues | All queues (cached, supports fields) | | get_queue | Queue details (expand: components, versions) | | create_queue | Create queue (invalidates cache) | | delete_queue | Delete queue (invalidates cache) | | restore_queue | Restore deleted queue (invalidates cache) | | list_queue_versions | List queue versions | | create_queue_version | Create version | | delete_queue_tag | Delete queue tag (invalidates cache) | | get_queue_user_permissions | Get user permissions for queue | | update_queue_permissions | Update queue access permissions |

Users (3)

| Tool | Description | |------|-------------| | get_myself | Current user info | | get_user | Get specific user info | | list_users | Organization users (cached, supports fields) |

Cache Management (4)

| Tool | Description | |------|-------------| | get_cache_status | Show status of directories cache (TTL, last updated, record count) | | sync_directory | Manually sync a specific directory from API (supports scope) | | sync_all_directories | Force sync all basic directories from API | | configure_cache | Configure TTL for a specific directory cache |

Universal Parameters: Most list_, get_ and search_* tools (Issues, Entities, Queues, Components, Boards, Sprints, Users, Fields) now support: - fields: list[str] — Additional fields to show. Use ["all"] to see every field available in the API. - output_format: str — Response format: "text" (default, markdown) or "json" (structured data for programmatic use). - full_description: bool — Set to true to return full description without truncation (default: false, truncates at 1000 chars). - use_cache: bool — (For cached tools) Set to False to bypass local cache and fetch fresh data from Yandex Tracker.

Directories — Reference Data (27)

| Tool | Description | |------|-------------| | list_issue_types | All issue types (cached) | | create_issue_type | Create issue type (invalidates cache) | | update_issue_type | Update issue type | | list_statuses | All statuses (cached) | | create_status | Create status (invalidates cache) | | update_status | Update status | | list_priorities | All priorities (cached) | | create_priority | Create priority (invalidates cache) | | update_priority | Update priority | | list_resolutions | All resolutions (cached) | | create_resolution | Create resolution (invalidates cache) | | update_resolution | Update resolution | | list_global_fields | Global fields (cached, supports fields) | | get_field | Get field details | | create_field | Create global field | | update_field | Update global field | | list_queue_fields | Queue fields (cached, supports fields) | | get_local_field | Get local field | | create_local_field | Create local field | | update_local_field | Update local field | | list_queue_tags | Queue tags (cached) | | list_components | All components (cached, supports fields) | | get_component | Get component details by ID (uses cache) | | create_component | Create component (invalidates cache) | | update_component | Update component (invalidates cache) | | list_field_categories | List field categories (cached) | | create_field_category | Create field category (bilingual name) | | update_field_category | Update field category |

Automations (15)

| Tool | Description | |------|-------------| | list_macros | List queue macros | | get_macro | Get macro details | | create_macro | Create macro | | update_macro | Update macro | | delete_macro | Delete macro | | list_triggers | List queue triggers | | get_trigger | Get trigger details | | create_trigger | Create trigger | | update_trigger | Update trigger | | get_trigger_logs | Get trigger execution logs | | list_autoactions | List queue autoactions | | get_autoaction | Get autoaction details | | create_autoaction | Create autoaction | | get_autoaction_logs | Get autoaction execution logs |

Bulk Operations (5)

| Tool | Description | |------|-------------| | bulk_update | Update multiple issues | | bulk_move | Move issues to queue | | bulk_transition | Transition multiple issues | | get_bulk_status | Check operation status | | get_bulk_failed_issues | Get failed issues from bulk operation |

Bulk Reads (1)

Parallel fan-out for read operations — one tool call instead of N, with compact output by default.

| Tool | Description | |------|-------------| | bulk_list_links | Fetch links for multiple issues in parallel (filter by type, compact format, configurable concurrency) |

Import (4)

| Tool | Description | |------|-------------| | import_issue | Import with original dates/author | | import_comment | Import comment | | import_link | Import link | | import_file | Import file attachment |

Filters (3)

| Tool | Description | |------|-------------| | create_filter | Create saved filter | | get_filter | Get filter details | | update_filter | Update filter |

Dashboards (2)

| Tool | Description | |------|-------------| | create_dashboard | Create dashboard | | create_cycle_time_widget | Create cycle time widget |

External Links (4)

| Tool | Description | |------|-------------| | list_external_applications | List registered external apps | | list_external_links | List external links on issue | | create_external_link | Create external link | | delete_external_link | Delete external link |

Overviews (2)

| Tool | Description | |------|-------------| | issue_overview | Full issue summary (status, links, comments, checklist, worklog) | | queue_overview | Queue summary (open count, top priority issues) |

Presets (5)

| Tool | Description | |------|-------------| | list_presets | Available task presets | | get_preset | Preset details (params, template, rules) | | create_from_preset | Create issue from preset (supports overrides and extra_fields) | | add_preset | Add or update a preset at runtime (params supports all create_issue fields) | | remove_preset | Remove a preset |

Team Directory (3)

| Tool | Description | |------|-------------| | list_team | Team members | | get_team_member | Member details (areas, queues) | | find_assignee | Find assignee by area/queue |

Resources (7)

| Resource | Description | |----------|-------------| | tracker://query-language | Query language syntax | | tracker://yfm-syntax | YFM markdown reference | | tracker://link-types | Issue link types | | tracker://entity-statuses | Entity status values | | tracker://field-types | Field types with Java paths | | tracker://api-errors | API error codes | | tracker://tips | Tips & caveats (local fields, bulk ops, query tricks) |

Prompts (4)

| Prompt | Description | |--------|-------------| | my_tasks | Show active tasks with priorities | | create_task_wizard | Step-by-step task creation | | issue_decomposition | Decompose issue into subtasks | | overdue_report | Overdue tasks report |

Configuration

Task Presets

Define presets in ~/.cache/ya-tracker-mcp/presets.yaml or manage at runtime with add_preset / remove_preset. params section supports all fields from create_issue (type, priority, assignee, tags, components, sprint, parent, project, followers, deadline, story_points, original_estimation, extra_fields):

presets:
  bug_report:
    name: "Bug report"
    description: "Bug with reproduction steps"
    params:
      type: "bug"
      priority: "critical"
      tags: ["bug", "regression"]
      components: ["API"]
    description_template: |
      ## Steps to reproduce
      {input.steps}
      ## Expected
      {input.expected}
      ## Actual
      {input.actual}
    rules:
      - "Always include reproduction steps"

Team Directory

Edit ~/.cache/ya-tracker-mcp/team.yaml to enable smart assignee suggestions:

team:
  - login: "user3370"
    name: "Ivan Ivanov"
    role: "Backend developer"
    areas: ["API", "auth", "databases"]
    queues: ["DEV"]
    notes: "Tech lead"

Query Language Examples

# My open tasks
Assignee: me() Resolution: empty()

# Critical bugs
Type: bug Priority: Critical, Blocker Resolution: empty()

# Overdue tasks
Deadline: <today() Resolution: empty()

# Updated this week
Updated: >today()-1w Queue: DEV

# Tasks in sprint
Sprint: "Sprint 24" Resolution: empty()

Development

git clone https://github.com/keemor/ya-tracker-mcp.git
cd ya-tracker-mcp
uv sync

# Run locally
YA_TRACKER_TOKEN=... YA_TRACKER_ORG_ID=... uv run ya-tracker-mcp

License

MIT