Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@YouTrack MCP ServerShow me all unresolved bugs in the Mobile project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
YouTrack MCP Server
A comprehensive Model Context Protocol (MCP) server for JetBrains YouTrack. Provides full REST API access through 44 tools for AI agents.
Features
44 tools covering issues, comments, projects, sprints, custom fields, time tracking, tags, users, activities, attachments, saved queries, and batch commands
Works with any YouTrack instance (Cloud or Server)
Zero config -- just set two environment variables
Full YouTrack query language support
Optimized API calls with selective field loading
Quick Start
npx @abdullahtas/youtrack-mcp-serverRequires two environment variables:
Variable | Required | Description |
| Yes | Your YouTrack instance URL (e.g. |
| Yes | Permanent token for authentication |
How to get a token: YouTrack Profile -> Authentication -> New token. Grant the scope needed for your use case (typically YouTrack).
Usage with Claude Desktop
Add the following to your Claude Desktop configuration file:
{
"mcpServers": {
"youtrack": {
"command": "npx",
"args": ["-y", "@abdullahtas/youtrack-mcp-server"],
"env": {
"YOUTRACK_URL": "https://your-instance.youtrack.cloud",
"YOUTRACK_TOKEN": "perm:your-token-here"
}
}
}
}Usage with Claude Code
claude mcp add youtrack -- env YOUTRACK_URL=https://your-instance.youtrack.cloud YOUTRACK_TOKEN=perm:xxx npx -y @abdullahtas/youtrack-mcp-serverAvailable Tools
Issues
Tool | Description |
| Create a new issue in a YouTrack project |
| Get details of a specific issue by its readable ID (e.g. "BC-123") |
| Update an existing issue (summary and/or description) |
| Delete an issue by its readable ID |
| Search for issues using YouTrack query language |
| Link two issues together with a specified link type |
| Get all links for a specific issue |
Comments
Tool | Description |
| Get comments for a specific issue |
| Add a comment to an issue |
| Update an existing comment on an issue |
| Delete a comment from an issue |
Projects
Tool | Description |
| List all projects in YouTrack |
| Get details of a specific project |
| Get issues belonging to a specific project, optionally filtered by query |
Agile & Sprints
Tool | Description |
| List all agile boards in YouTrack |
| Get details of a specific agile board including its sprints |
| List all sprints for a specific agile board |
| Get details of a specific sprint including its issues |
| Get the current active sprint for a specific agile board |
| Create a new sprint on an agile board |
| Update an existing sprint on an agile board |
| Add an issue to a sprint using its readable ID |
Custom Fields
Tool | Description |
| Get all custom fields for a specific issue |
| Update a custom field value on an issue |
| Get all custom field definitions for a project |
Time Tracking
Tool | Description |
| Get time tracking work items for an issue |
| Add a time tracking work item to an issue |
| Update an existing time tracking work item |
| Delete a time tracking work item from an issue |
Tags
Tool | Description |
| List all issue tags in YouTrack |
| Create a new issue tag |
| Add a tag to an issue |
| Remove a tag from an issue |
Users
Tool | Description |
| Get the currently authenticated YouTrack user |
| List YouTrack users |
| Get a specific YouTrack user by ID |
Activities
Tool | Description |
| Get activity history for a specific issue |
| Get global activity stream across all issues |
Attachments
Tool | Description |
| Get all attachments for an issue |
| Delete an attachment from an issue |
Saved Queries
Tool | Description |
| List all saved search queries in YouTrack |
| Create a new saved search query |
Power Tools
Tool | Description |
| Execute a YouTrack command on one or more issues (e.g. "State In Progress", "Assignee me") |
| Execute a raw YouTrack query and return issues with custom fields specification |
License
MIT
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.