ymcp YouTrack MCP
ymcp is a local toolchain for project work in YouTrack, including self-hosted instances behind a VPN. It has two parts: an MCP server for any AI client, and pipelines that hand issues to coding agents. The MCP server speaks for you with your login and password, ships every tool of YouTrack’s built-in MCP server under the same names, and adds the ones it lacks: deleting things, sprints, attachments, history, time reports, commands and more.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
What you can do with it
- Manage YouTrack issues, sprints, and attachments via AI agents
- Hand YouTrack issues to coding agents like Claude Code or Kimi
- Generate pull requests and handle review comments automatically
- Install and run as a single static binary on macOS, Linux, or Windows
Source and maintenance
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
docker.io/xlsoftware/ymcp:0.27.0
{
"transport": "stdio",
"identifier": "docker.io/xlsoftware/ymcp:0.27.0",
"registryType": "oci",
"packageArguments": [
{
"type": "positional",
"value": "serve",
"description": "Serve over stdio"
}
],
"environmentVariables": [
{
"name": "YOUTRACK_URL",
"format": "string",
"isRequired": true,
"description": "Instance root, e.g. https://youtrack.example.com (no /api)"
},
{
"name": "YOUTRACK_LOGIN",
"format": "string",
"isRequired": true,
"description": "YouTrack or Hub account, LDAP included"
},
{
"name": "YOUTRACK_PASSWORD",
"format": "string",
"isRequired": true,
"description": "Password of that account"
},
{
"name": "YOUTRACK_PROXY",
"format": "string",
"description": "Empty for HTTP(S)_PROXY, none to connect directly, or a proxy URL"
},
{
"name": "YMCP_TOOLS",
"format": "string",
"description": "Tool groups to serve, e.g. issues,articles or -api,-agile"
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"ymcp-youtrack-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"YOUTRACK_URL=<YOUR_YOUTRACK_URL>",
"-e",
"YOUTRACK_LOGIN=<YOUR_YOUTRACK_LOGIN>",
"-e",
"YOUTRACK_PASSWORD=<YOUR_YOUTRACK_PASSWORD>",
"-e",
"YOUTRACK_PROXY=<YOUR_YOUTRACK_PROXY>",
"-e",
"YMCP_TOOLS=<YOUR_YMCP_TOOLS>",
"docker.io/xlsoftware/ymcp:0.27.0",
"serve"
],
"env": {
"YOUTRACK_URL": "<YOUR_YOUTRACK_URL>",
"YOUTRACK_LOGIN": "<YOUR_YOUTRACK_LOGIN>",
"YOUTRACK_PASSWORD": "<YOUR_YOUTRACK_PASSWORD>",
"YOUTRACK_PROXY": "<YOUR_YOUTRACK_PROXY>",
"YMCP_TOOLS": "<YOUR_YMCP_TOOLS>"
}
}
}
}Cline
{
"mcpServers": {
"ymcp-youtrack-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"YOUTRACK_URL=<YOUR_YOUTRACK_URL>",
"-e",
"YOUTRACK_LOGIN=<YOUR_YOUTRACK_LOGIN>",
"-e",
"YOUTRACK_PASSWORD=<YOUR_YOUTRACK_PASSWORD>",
"-e",
"YOUTRACK_PROXY=<YOUR_YOUTRACK_PROXY>",
"-e",
"YMCP_TOOLS=<YOUR_YMCP_TOOLS>",
"docker.io/xlsoftware/ymcp:0.27.0",
"serve"
],
"env": {
"YOUTRACK_URL": "<YOUR_YOUTRACK_URL>",
"YOUTRACK_LOGIN": "<YOUR_YOUTRACK_LOGIN>",
"YOUTRACK_PASSWORD": "<YOUR_YOUTRACK_PASSWORD>",
"YOUTRACK_PROXY": "<YOUR_YOUTRACK_PROXY>",
"YMCP_TOOLS": "<YOUR_YMCP_TOOLS>"
}
}
}
}VS Code
{
"servers": {
"ymcp-youtrack-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"YOUTRACK_URL=<YOUR_YOUTRACK_URL>",
"-e",
"YOUTRACK_LOGIN=<YOUR_YOUTRACK_LOGIN>",
"-e",
"YOUTRACK_PASSWORD=<YOUR_YOUTRACK_PASSWORD>",
"-e",
"YOUTRACK_PROXY=<YOUR_YOUTRACK_PROXY>",
"-e",
"YMCP_TOOLS=<YOUR_YMCP_TOOLS>",
"docker.io/xlsoftware/ymcp:0.27.0",
"serve"
],
"env": {
"YOUTRACK_URL": "<YOUR_YOUTRACK_URL>",
"YOUTRACK_LOGIN": "<YOUR_YOUTRACK_LOGIN>",
"YOUTRACK_PASSWORD": "<YOUR_YOUTRACK_PASSWORD>",
"YOUTRACK_PROXY": "<YOUR_YOUTRACK_PROXY>",
"YMCP_TOOLS": "<YOUR_YMCP_TOOLS>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"ymcp-youtrack-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"YOUTRACK_URL=<YOUR_YOUTRACK_URL>",
"-e",
"YOUTRACK_LOGIN=<YOUR_YOUTRACK_LOGIN>",
"-e",
"YOUTRACK_PASSWORD=<YOUR_YOUTRACK_PASSWORD>",
"-e",
"YOUTRACK_PROXY=<YOUR_YOUTRACK_PROXY>",
"-e",
"YMCP_TOOLS=<YOUR_YMCP_TOOLS>",
"docker.io/xlsoftware/ymcp:0.27.0",
"serve"
],
"env": {
"YOUTRACK_URL": "<YOUR_YOUTRACK_URL>",
"YOUTRACK_LOGIN": "<YOUR_YOUTRACK_LOGIN>",
"YOUTRACK_PASSWORD": "<YOUR_YOUTRACK_PASSWORD>",
"YOUTRACK_PROXY": "<YOUR_YOUTRACK_PROXY>",
"YMCP_TOOLS": "<YOUR_YMCP_TOOLS>"
}
}
}
}Let your agent find its tools
Find servers like ymcp YouTrack MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.