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.
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
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
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.
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.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
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.
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.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
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.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.