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