MCP Jira Server for Self-Hosted Jira

A Model Context Protocol (MCP) server for interacting with self-hosted Jira instances using Personal Access Token (PAT) authentication.

Features

• ✅ Personal Access Token authentication for self-hosted Jira
• ✅ Create, read, update, and delete Jira issues
• ✅ Search issues using JQL (Jira Query Language)
• ✅ Add and view comments
• ✅ Manage issue assignments
• ✅ List projects and issue types
• ✅ Transition issues between statuses
• ✅ Get current user information

Prerequisites

• Node.js 18 or higher
• A self-hosted Jira instance (e.g., https://jira.domain.com)
• A Jira Personal Access Token

How to Create a Personal Access Token in Self-Hosted Jira

1. Log in to your Jira instance (e.g., https://jira.domain.com)
2. Click on your profile icon in the top right corner
3. Select “Profile” or “Account Settings”
4. Navigate to “Personal Access Tokens” or “Security”
5. Click “Create token”
6. Give your token a name (e.g., “MCP Server”)
7. Set an expiration date (optional but recommended)
8. Click “Create”
9. Copy the token immediately - you won’t be able to see it again!

Installation

Option 1: Using npm (Recommended)

Direct usage with npx:

npx mcp-jira-server

Or install globally:

npm install -g mcp-jira-server

Option 2: From Source

1. Clone the repository:

git clone https://github.com/edrich13/mcp-jira-server.git
cd mcp-jira-server

2. Install dependencies:

npm install

3. Build the server:

npm run build

Configuration

For Claude Desktop

Add the following to your Claude Desktop configuration file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Option 1: Using npx (Recommended)

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "mcp-jira-server"],
      "env": {
        "JIRA_BASE_URL": "https://jira.domain.com",
        "JIRA_PAT": "your-personal-access-token-here"
      }
    }
  }
}

Option 2: Using source build

{
  "mcpServers": {
    "jira": {
      "type": "stdio",
      "command": "node",
      "args": ["/Users/edrich.rocha/.nvm/versions/node/v22.6.0/bin/mcp-jira-server"],
      "env": {
        "JIRA_BASE_URL": "https://jira.domain.com",
        "JIRA_PAT": "your-personal-access-token-here"
      }
    }
  }
}

For VS Code with MCP

Create or update .vscode/mcp.json in your workspace:

Option 1: Using npx (Recommended)

{
  "servers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "mcp-jira-server"],
      "env": {
        "JIRA_BASE_URL": "https://jira.domain.com",
        "JIRA_PAT": "your-personal-access-token-here"
      }
    }
  }
}

Option 2: Using source build

{
  "servers": {
    "jira": {
      "command": "node",