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-server

Requires two environment variables:

Variable	Required	Description
YOUTRACK_URL	Yes	Your YouTrack instance URL (e.g. https://your-org.youtrack.cloud)
YOUTRACK_TOKEN	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-server

Available Tools

Issues

Tool	Description
create_issue	Create a new issue in a YouTrack project
get_issue	Get details of a specific issue by its readable ID (e.g. "BC-123")
update_issue	Update an existing issue (summary and/or description)
delete_issue	Delete an issue by its readable ID
search_issues	Search for issues using YouTrack query language
link_issues	Link two issues together with a specified link type
get_issue_links	Get all links for a specific issue

Comments

Tool	Description
get_comments	Get comments for a specific issue
add_comment	Add a comment to an issue
update_comment	Update an existing comment on an issue
delete_comment	Delete a comment from an issue

Projects

Tool	Description
list_projects	List all projects in YouTrack
get_project	Get details of a specific project
get_project_issues	Get issues belonging to a specific project, optionally filtered by query

Agile & Sprints

Tool	Description
list_agile_boards	List all agile boards in YouTrack
get_agile_board	Get details of a specific agile board including its sprints
list_sprints	List all sprints for a specific agile board
get_sprint	Get details of a specific sprint including its issues
get_current_sprint	Get the current active sprint for a specific agile board
create_sprint	Create a new sprint on an agile board
update_sprint	Update an existing sprint on an agile board
add_issue_to_sprint	Add an issue to a sprint using its readable ID

Custom Fields

Tool	Description
get_issue_custom_fields	Get all custom fields for a specific issue
update_custom_field	Update a custom field value on an issue
get_project_custom_fields	Get all custom field definitions for a project

Time Tracking

Tool	Description
get_work_items	Get time tracking work items for an issue
add_work_item	Add a time tracking work item to an issue
update_work_item	Update an existing time tracking work item
delete_work_item	Delete a time tracking work item from an issue

Tags

Tool	Description
list_tags	List all issue tags in YouTrack
create_tag	Create a new issue tag
add_tag	Add a tag to an issue
remove_tag	Remove a tag from an issue

Users

Tool	Description
get_current_user	Get the currently authenticated YouTrack user
list_users	List YouTrack users
get_user	Get a specific YouTrack user by ID

Activities

Tool	Description
get_issue_activities	Get activity history for a specific issue
get_activities	Get global activity stream across all issues

Attachments

Tool	Description
get_attachments	Get all attachments for an issue
delete_attachment	Delete an attachment from an issue

Saved Queries

Tool	Description
list_saved_queries	List all saved search queries in YouTrack
create_saved_query	Create a new saved search query

Power Tools

Tool	Description
execute_command	Execute a YouTrack command on one or more issues (e.g. "State In Progress", "Assignee me")
raw_query	Execute a raw YouTrack query and return issues with custom fields specification

License

MIT