@khanglvm/jira-mcp

MCP server for legacy Jira Server (v7.x) with Basic Authentication. Works with any MCP-compatible AI tool.

🔔 Using Jira Cloud or Data Center 8.14+? Use mcp-atlassian instead for OAuth/PAT support.

📋 Prerequisites

Node.js (v18+) is required for MCP servers and the installer to work.

macOS / Linux:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

Windows (PowerShell):

winget install -e --id OpenJS.NodeJS.LTS

🚀 Quick Install

Run this single command to interactively configure Jira MCP for your AI tool:

bash <(curl -fsSL https://raw.githubusercontent.com/khanglvm/jira-mcp/main/scripts/install.sh)

The installer auto-detects installed tools, supports multi-select, safely merges config, and creates backups.

📦 Configuration Formats

JSON (camelCase) - Claude Desktop, Claude Code, Antigravity, Cursor

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "@khanglvm/jira-mcp"],
      "env": {
        "JIRA_BASE_URL": "http://jira.example.com:8080",
        "JIRA_USERNAME": "your-username",
        "JIRA_PASSWORD": "your-password"
      }
    }
  }
}

JSON (dash-case) - VS Code, GitHub Copilot

{
  "servers": {
    "jira": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@khanglvm/jira-mcp"],
      "env": {
        "JIRA_BASE_URL": "http://jira.example.com:8080",
        "JIRA_USERNAME": "your-username",
        "JIRA_PASSWORD": "your-password"
      }
    }
  }
}

YAML (Codex)

mcp_servers:
  jira:
    command: npx
    args:
      - -y
      - "@khanglvm/jira-mcp"
    env:
      JIRA_BASE_URL: http://jira.example.com:8080
      JIRA_USERNAME: your-username
      JIRA_PASSWORD: your-password

🔧 Available Tools

| Tool | Description | |------|-------------| | jira_get_issue | Get issue details by key | | jira_create_issue | Create a new issue | | jira_update_issue | Update issue fields | | jira_delete_issue | Delete an issue | | jira_add_comment | Add comment to issue | | jira_get_comments | Get issue comments | | jira_search | Search issues using JQL | | jira_list_projects | List all accessible projects | | jira_get_project | Get project details | | jira_get_transitions | Get available transitions | | jira_transition_issue | Transition issue to new status | | jira_get_current_user | Get authenticated user info | | jira_get_user | Get user by username |

⚙️ Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | JIRA_BASE_URL | ✅ | Jira instance URL | | JIRA_USERNAME | ✅ | Username | | JIRA_PASSWORD | ✅ | Password | | JIRA_API_VERSION | ❌ | API version (default: 2) |

License

MIT