MCP Jira Integration

by Warzuponus

10 stars
394 downloads
Not rated
GitHub

About

JIRA integration server for Model Context Protocol (MCP) - enables LLMs to interact with JIRA tasks and workflows

Details

Author
Warzuponus
GitHub stars
10
Downloads
394
Categories
Productivity, Project Management, Developer Tools

- Create Jira issues with proper ADF formatting
- Search issues using JQL with pagination
- Get comprehensive sprint progress reports
- Analyze team member workloads and capacity
- Generate automated daily standup reports
- Automatic retry with exponential backoff on errors

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP Jira Integration
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Clone the repository, install dependencies in a virtual environment, and configure Jira credentials in a .env file. Run the server with python -m mcp_jira and connect it to any MCP-compatible client (e.g., Claude Desktop) by adding the server entry to the client’s configuration file.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp jira integration": {
            "mcp-jira-warzuponus": {
                "command": "python3",
                "args": [
                    "-m",
                    "venv",
                    ".venv"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-jira-warzuponus": {
        "command": "python3",
        "args": [
            "-m",
            "venv",
            ".venv"
        ]
    }
}

MCP Jira Integration

A simple Model Context Protocol (MCP) server for Jira that allows LLMs to act as project managers and personal assistants for teams using Jira. Built on the Jira REST API v3.

Features

Core MCP Tools

- create_issue - Create new Jira issues with proper formatting and ADF descriptions - search_issues - Search issues using JQL with smart formatting and pagination - get_sprint_status - Get comprehensive sprint progress reports with metrics - get_team_workload - Analyze team member workloads and capacity - generate_standup_report - Generate daily standup reports automatically

Project Management Capabilities

- Multi-Project Support: Work with multiple projects by specifying project keys dynamically - Sprint progress tracking with visual indicators - Team workload analysis and capacity planning - Automated daily standup report generation - Issue creation with proper prioritization - Smart search and filtering of issues

Reliability

- Automatic retry with exponential backoff on rate limits (429) and transient errors (503) - Pagination for large result sets - Timezone-aware date handling - Graceful handling of custom Jira statuses and issue types

Requirements

- Python 3.8 or higher
- Jira Cloud account with API token
- MCP-compatible client (like Claude Desktop)

Quick Setup

1. Clone and install:

git clone https://github.com/your-org/mcp-jira.git
cd mcp-jira
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

2. Configure Jira credentials:
```bash
cp .env.example .env

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.