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.
Ask AI about YouTrack MCP Server
Powered by Claude · Grounded in docs
I know everything about YouTrack MCP Server. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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
