jira_mcp_py

MCP.Pizza Chef: Ivlad003

jira_mcp_py is a Model Context Protocol (MCP) server designed to integrate Jira with large language models like Claude. It provides tools to execute JQL queries, retrieve detailed Jira ticket information, and automatically detect pull request links within ticket descriptions and comments. The server supports customizable project context, enhancing the relevance and precision of Jira data interactions. It requires Python 3.10+, a Jira account with API access, and works with MCP clients such as Claude Desktop. This server streamlines Jira data access and manipulation for AI-driven workflows and automation.

Unmaintained · No commits in 19 months.

Use This MCP server To

Run JQL queries on Jira instances Retrieve detailed Jira ticket information Automatically extract pull request links from tickets Customize project context for Jira operations

README

MCP Jira Server

A Model Context Protocol (MCP) server that provides Jira integration for LLMs like Claude. This server exposes tools for executing JQL queries and retrieving detailed ticket information.

Features

  • JQL Query Tool: Run JQL (Jira Query Language) queries against your Jira instance
  • Ticket Details Tool: Get comprehensive information about specific Jira tickets
  • PR Link Detection: Automatically extracts pull request links from descriptions and comments
  • Project Context: Customizable project context for all operations

Installation

Prerequisites

  • Python 3.10 or higher
  • A Jira account with API access
  • Claude Desktop or another MCP client

Setup

  1. Clone this repository or download the source code

  2. Install dependencies:

    pip install mcp[cli] httpx
  3. Configure your Jira credentials as environment variables:

    export JIRA_DOMAIN="your-domain"  # e.g., "mycompany" if your Jira URL is https://mycompany.atlassian.net
    export JIRA_EMAIL="your-email@example.com"
    export JIRA_API_TOKEN="your-api-token"

    Note: You can generate a Jira API token from Atlassian Account Settings.

Usage with Claude Desktop

jira_mcp_py FAQ

How do I install jira_mcp_py?
Clone the repository, install dependencies with 'pip install mcp[cli] httpx', and configure Jira credentials as environment variables.
What Python version is required for jira_mcp_py?
Python 3.10 or higher is required to run jira_mcp_py.
How do I configure Jira credentials for jira_mcp_py?
Set environment variables like JIRA_DOMAIN, JIRA_EMAIL, and JIRA_API_TOKEN with your Jira account details.
Can jira_mcp_py detect pull request links automatically?
Yes, it extracts pull request links from Jira ticket descriptions and comments automatically.
Which MCP clients are compatible with jira_mcp_py?
It works with MCP clients such as Claude Desktop and other compatible MCP clients.
Is jira_mcp_py limited to a specific Jira project?
No, it supports customizable project context for all operations.
Does jira_mcp_py support multiple LLM providers?
Yes, it is designed to work with LLMs like Claude, and can be integrated with others such as OpenAI and Gemini.
How secure is the Jira API access in jira_mcp_py?
Jira API access uses your account credentials securely via environment variables, minimizing exposure risks.