📋 Jira MCP Server

Project Management Integration

Comprehensive Jira integration for issue tracking, project management, and agile development workflows in enterprise environments.

Jira Integration Features

Complete project management and issue tracking capabilities

🎯 Issue Management

  • Search and filter issues across projects
  • Access issue details, comments, and history
  • Track issue status and workflow transitions
  • View assignments and priority levels

📊 Project Analytics

  • Sprint planning and progress tracking
  • Burndown charts and velocity metrics
  • Team workload and capacity analysis
  • Release planning and timeline tracking

🔄 Workflow Integration

  • Custom field and workflow support
  • Board and epic management
  • Component and version tracking
  • Integration with development tools

Step-by-Step Setup

Follow these steps to connect to your Jira instance

Step 1: Install the Jira MCP Server

Install the Jira MCP server on your development machine:

# Install the Jira MCP server
npm install -g @mcp/jira-server

# Verify installation
mcp --version

Step 2: Create a Jira API Token

You need an API token to access your Jira instance:

  1. Go to your Jira instance (e.g., https://company.atlassian.net)
  2. Click your profile picture in the top-right corner
  3. Go to "Account settings" or "Manage account"
  4. Click "Security" in the left sidebar
  5. Click "Create and manage API tokens"
  6. Click "Create API token"
  7. Give it a name like "MCP Jira Integration"
  8. Copy the token (it starts with something like ATATT...)

Note: Save this token securely - you won't be able to see it again!

Step 3: Get Your Project Information

Ask your project manager or team lead for:

  • Jira URL (e.g., https://company.atlassian.net)
  • Project Keys you need access to (e.g., PROJ, DEV, TEST)
  • Your Jira username/email (usually your company email)

Step 4: Configure Your Jira Connection

Set up the connection using your credentials:

# Set your credentials (replace with actual values)
export JIRA_URL="https://company.atlassian.net"
export JIRA_USERNAME="your-email@company.com"
export JIRA_API_TOKEN="your-api-token-here"
export JIRA_PROJECTS="PROJ,DEV,TEST"

# Configure the MCP server
mcp config jira \
  --url $JIRA_URL \
  --username $JIRA_USERNAME \
  --api-token $JIRA_API_TOKEN \
  --project-keys $JIRA_PROJECTS \
  --readonly

Step 5: Test Your Connection

Verify everything is working:

# Test the connection
mcp test jira

# Verify authentication
mcp auth verify jira

# If successful, you should see:
# ✅ Jira connection successful
# ✅ Project access verified
# ✅ API permissions confirmed

Usage Examples

Access Jira data through Copilot and MCP integration

Method 1: Ask GitHub Copilot (Recommended)

In your IDE with GitHub Copilot, you can ask natural language questions:

Example questions you can ask Copilot:

  • "Show me all open bugs assigned to my team"
  • "What's the progress of our current sprint?"
  • "Find all high-priority issues in the PROJ project"
  • "What issues were completed last week?"
  • "Show me all tickets I'm assigned to"
  • "What are the most common types of bugs we're seeing?"

Copilot will automatically query your Jira instance and provide answers!

Method 2: Direct MCP Commands

You can also query Jira directly from your terminal:

Query open issues:

mcp query jira "show all open bugs assigned to my team"

Find project status:

mcp query jira "get sprint progress for project PROJ"

Search using JQL (Jira Query Language):

mcp query jira "project = PROJ AND status = 'In Progress'"

Get issue details:

mcp query jira "show details for issue PROJ-123"