yandex-tracker-mcp-lite

Unofficial MCP server for Yandex Tracker that keeps your agent's context for your work: 9 tools, about 1.2k tokens of tool definitions. The official server costs about 24.8k tokens before you ask anything, the most popular community server about 20.7k.

Лёгкий неофициальный MCP-сервер для Яндекс Трекера: 9 инструментов, около 1,2 тыс. токенов на описания инструментов вместо 24,8 тыс. у официального и 20,7 тыс. у aikts, ответы в 1,4–30 раз короче, всё остальное API доступно через один инструмент call_api. Настройка одной командой: uvx yandex-tracker-mcp-lite setup.

uvx yandex-tracker-mcp-lite setup

Measured

Same organisation, same questions, measured with bench/measure.py on 2026-11-08 against the official server at mcp.tracker.yandex.net and aikts/yandex-tracker-mcp (commit 51a0c0d, default settings and with TRACKER_ENTITIES_ENABLED). Character counts are exact; tokens are estimated at 3.3 characters per token.

Tool definitions. "Seen by the model" is name + description + input schema, the part a client sends to the model in every session. The full tools/list also carries output schemas and annotations, which clients keep to themselves; for aikts those output schemas are 128k of its 201k characters.

Answers to the same questions, characters returned (aikts needs two calls for an issue with comments):

Clients that load MCP tools on demand (Claude Code's tool search) pay less of the definitions up front; Codex, Cursor and Claude Desktop pay all of it in every session. The answers are smaller everywhere.

Related MCP server: Yandex Tracker MCP

Set up in two minutes

You need: a Tracker organisation you belong to, uv (for uvx), and a browser where you are signed in to Yandex with the account you use in Tracker.

The quick way

Run this in your own terminal (not through an agent's shell: the token would end up in its transcript):

uvx yandex-tracker-mcp-lite setup

It walks you through the steps below, opens the right pages, reads the token with a hidden prompt, detects whether your organisation is Yandex Cloud or Yandex 360, checks access, explains what is wrong if it fails, and adds the server to Claude Code. For other clients it prints ready configs (the token masked unless you pass --show-token).

By hand

1. Create an OAuth app at oauth.yandex.ru/client/new:

• choose «Для доступа к API или отладки» (API access or debugging). "No access to user data" there refers to the Yandex ID profile, not to Tracker;

• name it anything, give a contact email;

• in «Доступ к данным» type «трекер» and add «Чтение из трекера» (tracker:read) and «Запись в трекер» (tracker:write);

• «Создать приложение», copy the ClientID. You don't need the client secret.

2. Issue a token. Open this link with your ClientID, check that the account in the corner is the one you use in Tracker, press «Разрешить» and copy the token (y0_…, valid for a year):

https://oauth.yandex.ru/authorize?response_type=token&client_id=<ClientID>

3. Find the organisation id. Tracker → Администрирование → Организации, field «Идентификатор». The card's title tells you which variable to use:

4. Check it works (replace the two values, keep the quotes):

export TRACKER_TOKEN='y0_...'
export TRACKER_CLOUD_ORG_ID='bpf...'        # or TRACKER_ORG_ID for Yandex 360

curl -s https://api.tracker.yandex.net/v3/myself \
  -H "Authorization: OAuth $TRACKER_TOKEN" \
  -H "X-Cloud-Org-ID: $TRACKER_CLOUD_ORG_ID"   # X-Org-ID for Yandex 360

You should see your login. If not, see Troubleshooting.

5. Add the server. In the same shell:

Claude Code:

claude mcp add --scope user tracker \
  -e TRACKER_TOKEN="$TRACKER_TOKEN" \
  -e TRACKER_CLOUD_ORG_ID="$TRACKER_CLOUD_ORG_ID" \
  -- uvx yandex-tracker-mcp-lite

Codex (~/.codex/config.toml):

[mcp_servers.tracker]
command = "uvx"
args = ["yandex-tracker-mcp-lite"]
env = { TRACKER_TOKEN = "y0_...", TRACKER_CLOUD_ORG_ID = "bpf..." }

Cursor, Claude Desktop, anything else (mcpServers JSON):

{
  "mcpServers": {
    "tracker": {
      "command": "uvx",
      "args": ["yandex-tracker-mcp-lite"],
      "env": { "TRACKER_TOKEN": "y0_...", "TRACKER_CLOUD_ORG_ID": "bpf..." }
    }
  }
}

Restart the client and ask something like «что у меня в работе в трекере?».

Troubleshooting

Keep the token secret. It acts as you in Tracker. If it leaks (pasted into a chat, committed), revoke it in Yandex ID → Безопасность and issue a new one.

Variables

Saving the extra process. uvx keeps a small uv process (~26 MB) alongside the server. To avoid it, install once with uv tool install yandex-tracker-mcp-lite and use yandex-tracker-mcp-lite as the command instead of uvx yandex-tracker-mcp-lite. Update with uv tool upgrade yandex-tracker-mcp-lite.

The names match aikts/yandex-tracker-mcp, so switching is a change of command.

Tools

How it stays small

Following Anthropic's Writing effective tools for agents and the Claude Code MCP docs:

• A few tools for whole workflows, one escape hatch for the rest. get_issue answers "what's going on with DEV-123" in one call instead of four. Rare operations go through call_api(method, path, body), which costs ~200 tokens and covers the whole API.

• Server instructions that say when to look here. With tool search only tool names and server instructions load up front, so the instructions lead with the words people use: Yandex Tracker, Яндекс Трекер, задачи, тикеты, issue keys like DEV-123.

• Help arrives with the error. The query-language cheat sheet is not in any schema. When Tracker rejects a query, the error comes back with it. 401/403/404 errors say what to check next, and a search that has more pages says how to get them.

• Answers are shrunk, not dumped. Reference objects become their display text ("assignee": "Анна Петрова", "parent": "DEV-0 Auth epic"), bookkeeping fields (self, version, uids, counters) and empty values are dropped, timestamps lose their seconds, JSON has no indentation. call_api keeps ids and keys, because follow-up calls need them.

• People by name. assignee, followers and summon take a login, an email, a display name or me. If a name matches several people the call fails with the candidates instead of guessing.

• Annotations that clients act on. Read tools are readOnlyHint (Claude Code runs them in parallel), update_issue is idempotentHint (safe to retry after a dropped connection), creating tools are non-destructive.

• Schemas without pydantic decoration. No auto-generated titles, no anyOf: [X, null].

Limitations

• File upload is not supported yet (call_api sends JSON).

• Name resolution loads the organisation's user list once per session (up to 1000 users).

• Not affiliated with Yandex.

Development

uv run pytest                                      # offline tests
TRACKER_TEST_QUEUE=TEST uv run pytest -m live -s   # creates, edits, links and closes issues in TEST
uv run python bench/measure.py --issue TEST-1 --queue TEST [--aikts ~/src/yandex-tracker-mcp]

MIT licence.