YouTrack

YouTrack MCP is a server that exposes YouTrack functionality through the Model Context Protocol, enabling you to control issues, projects, and other YouTrack data from MCP clients. It provides practical, scriptable access for automation, integration, and desktop clients that speak MCP.

How to use

Connect your MCP client to the YouTrack MCP server to manage issues, projects, and comments. You can perform common operations such as updating issue attributes, creating issues, searching, and adding comments. Use simple, direct commands to perform frequent tasks like changing an issue’s state or priority, assigning it to a user, updating estimates, and adding notes.

How to install

Prerequisites: you need a working Node.js environment with npm installed so you can use MCP client commands. You can also run the MCP server client via Docker if you prefer containerized execution.

Option 1: Install and run with npm (global install) using the standard MCP client.

# Install globally (first option)
npm install -g youtrack-mcp-tonyzorin

# Or run directly with npx (no installation required)
npx youtrack-mcp-tonyzorin

Option 2: Install and run with npm using the GitHub Packages variant.

# Install globally (GitHub Packages variant)
npm install -g @tonyzorin/youtrack-mcp

# Or run directly with npx (no installation required)
npx @tonyzorin/youtrack-mcp

Configuration and startup notes

Before you start, configure access to your YouTrack instance by providing its URL and a valid API token. You can also control SSL verification if needed.

# Example environment configuration (adjust to your environment)
export YOUTRACK_URL="https://your-instance.youtrack.cloud/"
export YOUTRACK_API_TOKEN="your-token"
export YOUTRACK_VERIFY_SSL="true"

Troubleshooting and tips

If you encounter authentication or connection issues, verify that your YouTrack instance is reachable at the configured URL and that the API token has the required permissions. Ensure SSL verification settings match your connection requirements.

Example workflows

You can perform practical workflows by combining MCP commands to classify, assign, estimate, and progress issues. For example, triage a bug, assign it to a developer, estimate effort, and start work, then document the triage with a comment.

Comprehensive features overview

The server provides endpoints and helpers to manage issues, projects, searches, users, and attachments. It supports REST API integration with YouTrack and is designed to work smoothly with MCP clients across platforms.

Available tools

update_issue_state

Set the status of an issue using a simple string value (e.g., 'In Progress', 'Closed').

update_issue_priority

Change an issue's priority using a straightforward label (e.g., 'Critical', 'Normal').

update_issue_assignee

Assign an issue to a user by login name.

update_issue_type

Set the issue type (e.g., 'Bug', 'Feature', 'Task').

update_issue_estimation

Specify time estimates like '4h', '2d', or '3d 5h'.

update_comment

Add comments to an issue to document progress or decisions.

get_issue

Retrieve a specific issue by its ID.

search_issues

Find issues using text queries across your projects.

create_issue

Create a new issue in a given project with summary and description.