YouTrack MCP
YouTrack MCP gives agents YouTrack Cloud and Server issues through the REST API: search, create, update and comment.
- 100 ★ on the repository
- Last commit
Extended access
Why this level
- The YouTrack token gives the agent its owner's rights, including writes, unless the tool set is narrowed.
Install
- Works in
Manual install
docker run --rm -i -e YOUTRACK_URL=https://your-instance.youtrack.cloud -e YOUTRACK_API_TOKEN=perm-xxx.your-token tonyzorin/youtrack-mcp:latestThe Docker option from the README; the `-i` flag is required for stdio. Without Docker: `npx -y youtrack-mcp-tonyzorin`.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The YouTrack token gives the agent its owner's rights, including writes, unless the tool set is narrowed.
This is third-party code. Review the repository files before installing.
What it does
The MCP server runs locally through Docker, npx or Python and talks to YouTrack over the REST API. An agent in Cursor or Claude Desktop searches issues, creates them, changes fields and adds comments. Fields update with plain strings such as `update_issue_state("DEMO-123", "In Progress")`. The tool set is narrowed with `ENABLED_TOOLS` (allowlist) and `DISABLED_TOOLS` (denylist), so writes can be turned off and only reading kept. The project appeared in April 2025 and works on self-hosted Server that has not moved to 2025.3 with the built-in JetBrains MCP.
Who it is for. Teams on YouTrack whose agent should handle issues, especially on Server older than 2025.3.
Good fit when
- An agent searches issues by query and summarizes them in chat.
- A code error must become an issue in the right project.
- Issue state and fields are changed by phrase rather than by form.
- An agent gets read-only access through `ENABLED_TOOLS`.
Not a fit when
- The instance is YouTrack 2025.3 or newer and needs OAuth and the built-in `/mcp`.
- An agent cannot be given a permanent token with write rights.
- You need a server without Docker, Node.js or Python.
Example request
Find open DEMO project issues with high priority and add a comment to DEMO-123.MCP
- Transport
- stdio
- Authentication
- API key
Environment variables
YOUTRACK_URLrequired- YouTrack instance URL, Cloud or Server.
YOUTRACK_API_TOKENrequired, secret- YouTrack permanent token.
Limitations
A permanent YouTrack token and the instance URL are required. The npx option needs Node.js 18 and Python 3.14. Docker does not see client `env` variables, so pass them with `-e` flags in the arguments. Article tools need the YouTrack knowledge base. No minimum YouTrack version is published, so test on your instance. The token gives the agent its owner's rights, so for a first run it is safer to keep read-only access through `ENABLED_TOOLS`.
How to disable. Remove the `youtrack` entry from the MCP client configuration and revoke the permanent token in your YouTrack profile. Stop the container with `docker stop`.
FAQ
How does it differ from the official YouTrack MCP?
It runs on your side over the REST API, so it also works on Server before 2025.3. The JetBrains built-in MCP lives inside YouTrack at `/mcp`.
How do I keep it read-only?
Set `ENABLED_TOOLS=get_issue,search_issues,get_projects`, or hide write tools through `DISABLED_TOOLS`.
What about a self-signed certificate?
Set `YOUTRACK_VERIFY_SSL=false` for such a Server.
Where do I get a token?
Create a permanent token in your YouTrack profile and pass it as `YOUTRACK_API_TOKEN`.
How can I run it?
Docker, `npx -y youtrack-mcp-tonyzorin` and running from Python. Docker stdio needs the `-i` flag.
Discussion
No questions or reviews yet.
Related
MCP serverstracker-mcp
traker-mcp
A Yandex Tracker MCP server with 187 tools and a skill: issues, queues, boards, sprints and automation over API v3, with a read-only mode
The official Todoist MCP server: the agent finds, creates and updates tasks and projects in your account
A Yandex Tracker MCP server: queues, issues, comments, status transitions, sprints and search in Tracker query language
Jira MCP in Go: an agent searches issues by JQL, runs sprints, comments and worklogs and sees an issue's branches and pull requests on Cloud and Server
The official Taskade MCP and plugin: an agent manages workspace projects, tasks, automations and AI agents.
Teamwork.com tasks, Desk tickets, Spaces pages and chats for an agent: a hosted server with role profiles and a read-only mode
README in short
The README explains why the project exists beside the official MCP and compares them in a table. A quick start for Cursor and Claude Desktop through Docker and npx follows, then running from Python and a table of environment variables.