MCP Jira Server

AI meets Jira - Connect AI assistants to your Jira workspace with modular architecture and enhanced compatibility

<p align="center"> <img src="assets/atlassian_logo_icon.png" alt="Jira Logo" width="120" /> </p>

🚀 What is this?

MCP Jira Server enables AI assistants like Claude, Cline, Cursor, and other MCP-compatible tools to interact with Atlassian Jira using API token authentication - featuring modular architecture, enhanced AI client compatibility, and enterprise-ready performance. Choose only the modules you need for optimized memory usage.

✨ Features

🔧 46 Optimized Tools Across 4 Modules:

• Core Module (14): Essential CRUD operations, user management, project operations
• Agile Module (10): Sprint & board management, workflow operations
• Dashboard Module (8): Analytics, reporting, dashboard management
• Search Module (14): Enhanced search & Epic discovery, universal user search

🎯 Key Capabilities:

• ✅ Modern JQL API - Enhanced search with full issue data retrieval (no IDs-only limitation)
• ✅ Modular Architecture - Up to 64% memory reduction with selective loading
• ✅ Enhanced AI Client Compatibility - Comprehensive usage patterns & error prevention
• ✅ Production Ready - 100% test success rate across all 46 tools

🚀 Quick Start

📦 Install from NPM (Recommended)

npm install -g mcp-jira-cloud-server

📖 Complete Installation Guide - Follow the step-by-step setup guide

Architecture

Module Distribution (46 Total Tools - Optimized)

Module	Tools	Success Rate	Use Case
Core	14	100%	Essential CRUD operations
Agile	10	100%	Sprint & workflow management
Dashboard	8	100%	Analytics & reporting
Search	14	100%	Enhanced search & Epic discovery

Configuration Options

4 Deployment Options:

• Essential Stack (28 tools): Core + Search modules
• Complete Agile (38 tools): Core + Agile + Search modules
• Analytics Focus (22 tools): Search + Dashboard modules
• Legacy Compatibility (46 tools): All modules in single server

📖 Complete Configuration Guide - Detailed setup instructions with working configs

💡 Usage Examples

Create Issues with Natural Language:

Human: Create a new Epic called "User Authentication System" in the DEMO project

AI Assistant: I'll create that Epic for you using the createIssue tool:
□ Project: DEMO
□ Issue Type: Epic (auto-detected)
□ Summary: "User Authentication System"
□ Creating issue now...

✅ Created Epic DEMO-142: "User Authentication System"

Advanced Search & Analysis:

Human: Find all high-priority bugs assigned to me that were created last week

AI Assistant: I'll search for your high-priority bugs from last week:
□ Use enhancedSearchIssues with modern JQL API: "assignee = currentUser() AND priority = High AND issueType = Bug AND created >= -7d"
□ Enhanced API returns full issue details (no IDs-only limitation)
□ Found 3 matching issues with complete data in single API call
□ Analyzing priority, status, and resolution timeframes...

Found 3 high-priority bugs: DEMO-140, DEMO-138, DEMO-135 - details attached.

Sprint Management & Agile Workflows:

Human: Show me the current sprint status and add issue DEMO-123 to the active sprint

AI Assistant: I'll check your sprint status and add the issue:
□ Use listSprints to find active sprint for your board
□ Use getSprintIssues to see current sprint contents  
□ Use addIssueToSprint to add DEMO-123
□ Provide sprint summary with updated issue count

Current Sprint "Sprint 24" has 12 issues, adding DEMO-123 now... ✅ Added successfully!

🛠️ Tech Stack

• TypeScript - Type-safe development with strict mode
• Node.js - Runtime environment (16.x+)
• MCP Protocol - Model Context Protocol for AI integration
• Jira APIs - Native Jira Platform API v3 + Agile API v1.0
• Modular Architecture - Specialized modules for optimized performance

📄 License

MIT License - see LICENSE for details.

---

🎉 Connect your AI assistant to Jira with modular architecture and enhanced compatibility!