YouTrack MCP Server

YouTrack MCP Server

A comprehensive Model Context Protocol server that provides AI agents with 44 tools to manage JetBrains YouTrack issues, sprints, and projects via the REST API. It supports full YouTrack query language and works with both Cloud and Server instances for complete project management integration.

Category
Visit Server

README

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

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured