YouTrack import

Your YouTrack issues,
worked by the agent you choose

The sprint lives in YouTrack. The bugs and tasks assigned to you are there, with their description, their custom fields and their screenshots. What you want is an agent on each of them, on your own machine, in the CLI that suits the task.

AgentsRoom imports those issues into the project's backlog, with their description, their filled custom fields and their attached files. Each one becomes a ticket you hand to Claude Code, Codex, GitHub Copilot CLI, Cursor or another agent CLI, one agent per ticket. The import only reads: nothing is ever written back to YouTrack.

Download AgentsRoomFreeSee how it works

From YouTrack to your agents

YouTrack projects

WEB

APP

#Unresolved for: me

Backlog · TODO

WEB-412Claude Code

WEB-415Codex

APP-88Cursor

Read only: nothing written back

Two YouTrack projects, one search, one agent per ticket: the import reads YouTrack and never writes to it.

YouTrack is where a lot of teams plan the work: the agile board, the sprint, the bug that came in this morning. Claude Code, Codex and the other agent CLIs are where more and more of that work gets done. Between the two, the usual method is copy and paste: the title into a prompt, the description after it, the screenshots lost on the way.

The YouTrack import does that step for you. You connect your YouTrack, Cloud or self-hosted, with a permanent token, you pick a project or type any YouTrack search, you preview the issues and import them. They land in the TODO column of the project's backlog as ordinary tickets, with the description, the filled custom fields and the attached files, and you start an agent on each one like on any other ticket.

It is not a two-way sync. AgentsRoom only sends read requests to YouTrack: no state change, no comment, no field updated. If you want an agent to comment on an issue or resolve it, that is what YouTrack's own MCP server is for, and the two work together, as explained below.

What the YouTrack import does

One more source on the backlog, next to Jira, Linear, GitHub Issues, GitLab Issues, Azure DevOps and Notion.

A project or any YouTrack search

Pick one of your projects from the list, with a search field when there are dozens, and the search is written for you: project: ABC #Unresolved. Or type any search that works in YouTrack, an agile board or a sprint filter included, and add for: me to keep only your issues.

One issue, by its ID

Only need the bug you were just given? Paste ABC-123 or the issue link with the import button of the TODO column. It arrives on its own, at the top of the column, without touching the saved import.

Description and custom fields included

The import keeps the Markdown description of the issue and adds a short context block with the custom fields the team filled in, up to eight of them: priority, state, assignee, subsystem, estimation or your own fields. The agent reads the issue as the team wrote it.

Attachments the agent can open

Files attached to the issue sit behind your YouTrack login, so a link would be useless to the agent. The import downloads them on your computer, only from the instance you connected, and attaches them to the ticket: up to 10 per issue, 8 MB each.

Type and state that make sense

The Type field sets the ticket type: Bug, Cosmetics, Exception and Usability Problem become bugs, Performance Problem a performance ticket, Feature and Meta Issue features, and the type stays as a tag. Done is read from YouTrack's resolved flag, so an issue in any resolved state of your project arrives as done, whatever the state is called.

Read only, token on your machine

The import sends read requests only. The permanent token is encrypted on your computer, with the address of your instance, and never reaches our servers.

How it works

Four steps. The first two happen once per machine.

1
Create a permanent token
In YouTrack, open your profile, then Account Security, and create a permanent token with the YouTrack scope. It starts with perm:.
2
Connect your YouTrack
In the project's backlog, click Import tickets and pick YouTrack. Enter the address you open YouTrack with (yourteam.youtrack.cloud or your own server; pasting the link of an issue or a board works too) and the token.
3
Choose and preview
Pick a project or type a search, then click Preview. Search the list by ID or title, tick the issues you want and import them, up to 500 at a time.
4
Hand each ticket to an agent
The issues are now tickets in TODO, each with a link back to YouTrack. Assign an agent and a model, tick Code in a separate worktree for this task if you want it on its own branch, and drag the ticket to Development. Refresh brings the board back in step later.

What JetBrains and the agent CLIs already do on their own

YouTrack has its own MCP server, announced by JetBrains in October 2025. It answers at your instance address followed by /mcp (https://yourteam.youtrack.cloud/mcp on YouTrack Cloud) and accepts a permanent token or OAuth. For Claude Code, JetBrains' documentation gives claude mcp add --header "Authorization: Bearer <token>" --transport http youtrack followed by that address; any agent CLI that speaks MCP over HTTP can connect the same way.

Its tools search issues and articles, create and update them, add comments and attachments, manage tags and links and log work, with the permissions of the account behind the token. JetBrains advises reviewing every tool call that changes data, and adding readOnlyTools=true to the address keeps only the tools that read.

The AgentsRoom import answers another need: the issues on a board, next to the rest of your tickets, with one agent per issue on your own machine and in the CLI you choose, without giving any of them write access to YouTrack. The two are not exclusive: import the issues to plan and run the work, and give an agent the YouTrack MCP server when it should comment on or resolve its issue itself.

What to know

One YouTrack instance per computer, Cloud or self-hosted. To import from a second one, connect it instead of the first.
One way only: nothing goes back to YouTrack, even once the ticket ships here. Resolve the issue yourself, or give the agent the YouTrack MCP server.
The token stays on the computer that connected it. On another machine, you connect YouTrack again before you refresh the import there.
Up to 500 issues per import, and up to 10 attached files of 8 MB per issue.
Comments, links between issues and history are not imported: the ticket carries the title, the description, the custom fields block, the type tag and the files.
Connecting YouTrack and writing the search happen on the desktop. From the phone you can refresh the import or bring in one issue by its ID; both run on your computer, which must be on.

Frequently asked questions

Ask us something else

Is this the same thing as the YouTrack MCP server?

No. The YouTrack MCP server gives one agent tools to read and change YouTrack from inside its session. The AgentsRoom import brings the issues onto the project's backlog before any agent starts, so you can plan them, give each one to a different agent and follow them on the board. You can use both: the import to organise the work, the MCP server for an agent that should comment on or resolve its issue.

Can Claude Code use YouTrack?

Yes, two ways. Inside a session, add the YouTrack MCP server with claude mcp add --header "Authorization: Bearer <token>" --transport http youtrack followed by your instance address and /mcp, as JetBrains' documentation shows: the agent can then search, read and update issues itself. Before the session, import the issues into AgentsRoom and hand each one to a Claude Code agent: the description, the custom fields and the files reach the agent with its task.

Does AgentsRoom update the issue when the agent is done?

No. The import only sends read requests: no state change, no comment, no field updated. When the ticket ships here, you resolve the issue in YouTrack yourself, or you let an agent do it through the YouTrack MCP server.

Can I import only my issues, or only the current sprint?

Yes, with the search: add for: me to keep the issues assigned to you, and use a board or sprint filter the way you would in YouTrack. The search is saved with the project, so Refresh replays it later.

Can I bring in only the issue I was just assigned?

Yes. Use the import button of the TODO column and paste its ID (ABC-123) or its link. It lands at the top of TODO without changing the saved import, and it can be refreshed on its own later from the ticket.

Does my YouTrack token leave my computer?

No. It is stored encrypted on the computer that connected it, with the address of your instance, and never reaches our servers. Attachments are downloaded only from the instance you connected, so the token is never sent to another host.

Does it work with a self-hosted YouTrack?

Yes. Enter the address of your own server instead of a youtrack.cloud address, with a permanent token created on that server. YouTrack Cloud addresses work too, including the older myjetbrains.com/youtrack ones.

Which agent CLIs can work on an imported issue?

All 19 agent CLIs AgentsRoom supports (Claude, Codex, GitHub Copilot CLI, Cursor and 15 more). An imported issue is an ordinary ticket: it runs on whatever agent and model you assign it, in the shared checkout or in its own git worktree.