Install YouTrack (ymcp) in TUUI
What you need first
- TUUI, installed.
- Docker, which
gives the
dockercommand the server starts with. - Your own values for
YOUR_YOUTRACK_URL,YOUR_YOUTRACK_LOGIN,YOUR_YOUTRACK_PASSWORD.
Steps
- Open
~/.codex/config.toml, or create it. The Codex CLI, its IDE extension and the ChatGPT desktop app share this file. - Add this table at the end of the file.
{
"mcpServers": {
"ymcp": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "YOUTRACK_URL", "-e", "YOUTRACK_LOGIN", "-e", "YOUTRACK_PASSWORD", "docker.io/xlsoftware/ymcp:0.27.0", "serve"],
"env": { "YOUTRACK_URL": "YOUR_YOUTRACK_URL", "YOUTRACK_LOGIN": "YOUR_YOUTRACK_LOGIN", "YOUTRACK_PASSWORD": "YOUR_YOUTRACK_PASSWORD" }
}
}
} - Replace
YOUR_YOUTRACK_URL,YOUR_YOUTRACK_LOGIN,YOUR_YOUTRACK_PASSWORDwith your own values. - Save the file and restart TUUI.
Check it worked
Ask TUUI: List the tools of ymcp.
If it does not start
- Cannot connect to the Docker daemon
- Docker is not running. Start it, then restart TUUI.
- The server starts, but its tools fail
- A
YOUR_…placeholder is still in the config, or its value is wrong. - Nothing changes after a restart
- The file is not valid JSON any more. Look for a missing comma where the block was added.