Jira

by chase-bullock

Not rated

GitHub

About

Integrates with the Jira API, enabling JQL searches and issue detail retrieval for AI-assisted project management and issue tracking workflows.

Details

Author: chase-bullock
Repository: Chase-Bullock/python-jira-mcp
Categories: Productivity, AI, Developer Tools, Search, Project Management, Infrastructure, API

- JQL Search Tool: Search for Jira issues using JQL queries
- Get Issue Tool: Retrieve detailed information about a specific Jira issue
- MCP SDK Integration: Compatible with the official MCP Python SDK
- Fallback Mode: Minimal implementation when the SDK is not available
- Environment Configuration: Load Jira credentials from environment variables

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:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Jira

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 @highlight/mcp-server
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "jira": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "jira": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "jira": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "jira": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "jira": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

From the repository

To start the MCP server, run:

python main.py

Or use the executable directly:

./main.py

The server will start and listen for MCP messages on standard input (stdin) and respond on standard output (stdout).

`jql_search`

Search for Jira issues using JQL (Jira Query Language). Parameters: jql (string), max_results (integer), fields (array of strings)

`get_issue`

Retrieve details about a specific Jira issue by its ID or key. Parameters: issue_id_or_key (string), fields (array of strings), expand (string)

JQL Search

Search for Jira issues using JQL (Jira Query Language).

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "jira": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "cmd"
}

Python Jira MCP Server

A Model Context Protocol (MCP) server implementation in Python that integrates with Jira API. This allows AI models to interact with Jira through a standardized protocol.

Overview

This MCP server exposes Jira API operations as tools that can be used by AI models supporting the Model Context Protocol. The server implements the stdio transport mechanism to communicate with clients like Cursor.

Features

Requirements

- Python 3.8+
- Jira API access (API token, email, and domain)
- Required Python packages:
- mcp (Model Context Protocol Python SDK)
- aiohttp (for HTTP requests)
- pydantic (for validation)
- python-dotenv (for environment variables)

Installation

1. Clone this repository:

   git clone https://github.com/yourusername/python-jira-mcp.git
   cd python-jira-mcp

2. Install the dependencies:

   pip install -r requirements.txt

3. Set up your Jira credentials:

   cp .env.example .env

   # Edit .env with your Jira credentials

Usage

Running the Server

To start the MCP server, run:

python main.py

Or use the executable directly:

./main.py

The server will start and listen for MCP messages on standard input (stdin) and respond on standard output (stdout).

Integrating with Cursor

To use this MCP server with Cursor:

1. Start the server (as above)
2. In Cursor, configure the MCP server path to point to main.py
3. Use Jira tools directly within Cursor

Available Tools

JQL Search

Search for Jira issues using JQL (Jira Query Language).

No reviews yet — be the first

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

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

jql_search

get_issue

JQL Search

Claude Desktop / Cursor

Linux

Macos

Windows

Python Jira MCP Server

Overview

Features

Requirements

Installation

Usage

Running the Server

Integrating with Cursor

Available Tools

JQL Search

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7

`jql_search`

`get_issue`