YouTrack MCP Server

An MCP (Model Context Protocol) server that provides YouTrack REST API access to AI agents like GitHub Copilot, enabling real-time project management and issue tracking.

Features

• 🔍 Query and Search Issues: Use YouTrack's powerful query syntax to find issues
• 📊 Real-time Project Status: Get current project statistics and issue distributions
• ✨ Create New Issues: Add issues with full metadata (type, priority, description)
• 📝 Update Issues: Modify existing issues (state, assignee, priority, etc.)
• � Comment Management: Add and retrieve issue comments
• 👥 User Search: Find and search YouTrack users
• 📈 Project Analytics: Generate summaries and timeline reports
• 🔄 Bulk Operations: Update multiple issues simultaneously
• 🎣 Webhook Support: Real-time notifications (optional)
• 💾 Smart Caching: Improved performance with intelligent caching
• 📋 Comprehensive Logging: Detailed logs for monitoring and debugging

Quick Start

1. Clone and install:

git clone https://github.com/yourusername/youtrack-mcp.git
cd youtrack-mcp
npm install

2. Configure environment:

cp .env.example .env
# Edit .env with your YouTrack URL and token

3. Build and run:

npm run build
npm start

Configuration

Environment Variables

Variable	Required	Description	Default
YOUTRACK_URL	✅	YouTrack instance URL	-
YOUTRACK_TOKEN	✅	Permanent token	-
DEFAULT_PROJECT_ID	❌	Default project ID	-
ENABLE_WEBHOOKS	❌	Enable webhook server	false
WEBHOOK_PORT	❌	Webhook server port	3000
WEBHOOK_SECRET	❌	Webhook signature secret	-
LOG_LEVEL	❌	Logging level	info
CACHE_ENABLED	❌	Enable caching	true
CACHE_TTL	❌	Cache TTL (ms)	300000

MCP Client Configuration

Add to your MCP settings (e.g., in Cline, Claude Desktop, or other MCP clients):

{
  "mcpServers": {
    "youtrack": {
      "command": "node",
      "args": ["path/to/youtrack-mcp/dist/index.js"],
      "env": {
        "YOUTRACK_URL": "https://your-instance.youtrack.cloud",
        "YOUTRACK_TOKEN": "your-token"
      }
    }
  }
}

Available Tools

1. get_project_status

Get current project status including issue statistics.

2. create_issue

Create new issues with summary, description, type, and priority.

3. query_issues

Search issues using YouTrack query syntax.

4. update_issue

Update existing issues (state, assignee, priority, etc.).

5. get_project_issues_summary

Get aggregated statistics of issues by state, priority, and type.

Usage Examples

Query open bugs

query_issues({ query: "project: PROJ-1 type: Bug state: Open" })

Create a new feature request

create_issue({
  projectId: "PROJ-1",
  summary: "Add dark mode support",
  description: "Users want a dark theme option",
  type: "Feature",
  priority: "Normal"
})

Update issue state

update_issue({
  issueId: "PROJ-123",
  updates: {
    state: "In Progress",
    assignee: "john.doe"
  }
})

Development

# Run in development mode
npm run dev

# Build for production
npm run build

# Start production server
npm start

License

MIT