This project provides a Model Context Protocol (MCP) server for YouTrack, enabling seamless integration with Claude Desktop and other MCP clients.

Choose from multiple registries:

# Use the latest stable release
docker run --rm \
  -e YOUTRACK_URL="https://your-instance.youtrack.cloud" \
  -e YOUTRACK_API_TOKEN="your-token" \
  tonyzorin/youtrack-mcp:latest
# Or use the latest development build
docker run --rm \
  -e YOUTRACK_URL="https://your-instance.youtrack.cloud" \
  -e YOUTRACK_API_TOKEN="your-token" \
  tonyzorin/youtrack-mcp:1.1.2_wip

# Use the latest stable release
docker run --rm \
  -e YOUTRACK_URL="https://your-instance.youtrack.cloud" \
  -e YOUTRACK_API_TOKEN="your-token" \
  ghcr.io/tonyzorin/youtrack-mcp:latest
# Or use the latest development build
docker run --rm \
  -e YOUTRACK_URL="https://your-instance.youtrack.cloud" \
  -e YOUTRACK_API_TOKEN="your-token" \
  ghcr.io/tonyzorin/youtrack-mcp:1.1.2_wip

Both registries provide identical tags:

• latest - Latest stable release (currently 1.1.2)
• 1.1.2 - Specific version tags
• 1.1.2_wip - Work-in-progress builds from main branch
• pr-<number> - Pull request builds for testing

Note: Images are now published to both Docker Hub and GitHub Container Registry simultaneously.

Choose from multiple registries:

# Install globally
npm install -g youtrack-mcp-tonyzorin
# Or use with npx (no installation required)
npx youtrack-mcp-tonyzorin

# Configure GitHub registry
npm config set @tonyzorin:registry https://npm.pkg.github.com
# Install globally
npm install -g @tonyzorin/youtrack-mcp
# Or use with npx
npx @tonyzorin/youtrack-mcp

• Issue Management: Create, read, update, and delete YouTrack issues
• Project Management: Access project information and custom fields
• Search Capabilities: Advanced search with filters and custom fields
• User Management: Retrieve user information and permissions
• Attachment Support: Download and process issue attachments (up to 10MB)
• Multi-Platform Support: ARM64/Apple Silicon and AMD64 architecture support
• Comprehensive API: Full YouTrack REST API integration

This project maintains high code quality with comprehensive testing:

• Test Coverage: 41% (continuously improving)
• CI/CD Pipeline: Automated testing and Docker builds
• Quality Assurance: Automated testing on every commit

For development instructions, see the Automation Scripts Guide and Release Process.

• YOUTRACK_URL: Your YouTrack instance URL
• YOUTRACK_API_TOKEN: Your YouTrack API token
• YOUTRACK_VERIFY_SSL: SSL verification (default: true)

export YOUTRACK_URL="https://prodcamp.youtrack.cloud/"
export YOUTRACK_API_TOKEN="perm-YWRtaW4=.NDMtMg==.JgbpvnDbEu7RSWwAJT6Ab3iXgQyPwu"
export YOUTRACK_VERIFY_SSL="true"

• Development Workflow & Release Process
• Docker Tagging Strategy
• Testing Guide
• Automation Scripts

For issues and questions:

1. Check the Issues page
2. Review the documentation
3. Submit a new issue with detailed information
4. Contact directly: t.me/tonyzorin

Latest update: Comprehensive custom fields management with 567 test coverage and clean project organization.

🎉 MAJOR FEATURE - Custom Fields Management Support

• ✅ Complete custom fields CRUD operations (create, read, update, delete)
• ✅ Field validation against project schema (all field types supported)
• ✅ Batch update capabilities for performance
• ✅ Comprehensive error handling with detailed messages
• ✅ 567 tests (+68 new tests) with extensive coverage
• ✅ Clean project organization with automations/ directory