Jira MCP Server

Name: Jira MCP Server
Author: NoxFr

@NoxFr

Repository

About Jira MCP Server

No overview available yet

#kotlin #mcp #ktor #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-kotlin-jira-server": {
      "url": "http://127.0.0.1:3001/sse"
    },
    "mcp-kotlin-jira-stdio": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "JIRA_URL",
        "-e",
        "JIRA_EMAIL",
        "-e",
        "JIRA_PAT",
        "docker.io/library/jira-mcp-server-jira-mcp-server"
      ],
      "env": {
        "JIRA_URL": "TBD",
        "JIRA_EMAIL": "TBD",
        "JIRA_PAT": "TBD"
      }
    }
  }
}

Tools

Search JIRA issues using JQL.

Get detailed information about a specific JIRA issue including comments.

Update an existing JIRA issue.

Get available status transitions for a JIRA issue.

Change the status of a JIRA issue by performing a transition.

Search for JIRA users.

Assign a JIRA issue to a user.

Overview

What is Jira MCP Server?

Jira MCP Server is a bridge between Jira and the Model Context Protocol (MCP). It enables synchronization and interaction with Jira data through an MCP interface. It is built with Kotlin and Ktor, containerized with Docker, and intended for developers and teams who want to control Jira via AI assistants or MCP-compatible clients.

How to use Jira MCP Server?

Run the pre-built Docker images from GitHub Container Registry (ghcr.io/noxfr/jira-mcp-stdio or jira-mcp-sse). Configure the environment variables JIRA_URL, JIRA_EMAIL, and JIRA_API_TOKEN (or JIRA_PAT). The server supports two MCP transport modes: stdio and SSE. Example MCP client configurations are provided for both modes.

Key features of Jira MCP Server

Search Jira issues using JQL.
Get detailed issue information including comments.
Update existing Jira issues.
Retrieve available status transitions for an issue.
Change issue status via transitions.
Search for and assign Jira users.

Use cases of Jira MCP Server

Fix multiple tickets matching a label and set them to review via AI assistant.
Ask an AI assistant to suggest an implementation for a specific Jira ticket.
Automate routine Jira updates without leaving the chat interface.

FAQ from Jira MCP Server

What prerequisites are needed to run Jira MCP Server?

Java 21 or higher, Docker and Docker Compose, and a Jira account with appropriate permissions.

How do I configure the server?

Set the environment variables JIRA_URL, JIRA_EMAIL, and JIRA_API_TOKEN (or JIRA_PAT). For Docker Compose, provide them in the environment section of your compose file.