JIRA

by dsazz

2 stars

Not rated

GitHub

About

Integrates with Atlassian JIRA to retrieve issue details, list assigned tasks, and create tickets directly through conversation, using a modular architecture with clear separation between API clients, formatters, and tool implementations.

Details

Author: dsazz
Repository: Dsazz/mcp-jira
GitHub stars: 2
License: MIT License
Categories: Productivity, Project Management, Other, Design, Developer Tools, AI, Infrastructure
Tags: #integration

- Issue Management: Full CRUD operations for JIRA issues with comprehensive field support
- Project & Board Discovery: Browse projects, boards, and sprints with advanced filtering
- Smart Search: JQL and beginner-friendly search with rich formatting
- Comment System: Access and manage issue comments with progressive disclosure

- 🏗️ Enterprise-Grade Architecture _(New in v0.5.0)_

- Modular Design: Feature-based architecture with clear separation of concerns
- Robust HTTP Client: Refactored with dedicated utility classes for reliability
- Comprehensive Testing: 822+ tests ensuring stability and reliability
- Type Safety: Full TypeScript strict mode with enhanced error handling

- 🔍 Powerful Search & Discovery

- Search issues using JQL (JIRA Query Language) or beginner-friendly parameters
- Project, board, and sprint discovery with metadata and filtering
- Rich markdown formatting with issue previews and direct navigation links
- Advanced comment retrieval with author filtering and date ranges

- 📝 Advanced Issue Management
- Create, update, and transition issues with comprehensive field support
- Time tracking, worklog management, and custom field support
- ADF (Atlassian Document Format) parsing for rich content display
- Array operations for labels, components, and versions

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.) bunx
Arguments
- Argument 1 -y
- Argument 2 @dsazz/mcp-jira@latest
Environment
- JIRA_HOST https://your-domain.atlassian.net
- JIRA_USERNAME your-email@example.com
- JIRA_API_TOKEN your-jira-api-token
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": {
                "JIRA_HOST": "https://your-domain.atlassian.net",
                "JIRA_USERNAME": "your-email@example.com",
                "JIRA_API_TOKEN": "your-jira-api-token"
            },
            "args": [
                "-y",
                "@dsazz/mcp-jira@latest"
            ],
            "command": "bunx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_HOST": "https://your-domain.atlassian.net",
                "JIRA_USERNAME": "your-email@example.com",
                "JIRA_API_TOKEN": "your-jira-api-token"
            },
            "args": [
                "/c",
                "bunx",
                "-y",
                "@dsazz/mcp-jira@latest"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_HOST": "https://your-domain.atlassian.net",
                "JIRA_USERNAME": "your-email@example.com",
                "JIRA_API_TOKEN": "your-jira-api-token"
            },
            "args": [
                "-y",
                "@dsazz/mcp-jira@latest"
            ],
            "command": "bunx"
        }
    }
}

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": {
                "JIRA_HOST": "https://your-domain.atlassian.net",
                "JIRA_USERNAME": "your-email@example.com",
                "JIRA_API_TOKEN": "your-jira-api-token"
            },
            "args": [
                "-y",
                "@dsazz/mcp-jira@latest"
            ],
            "command": "bunx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_HOST": "https://your-domain.atlassian.net",
                "JIRA_USERNAME": "your-email@example.com",
                "JIRA_API_TOKEN": "your-jira-api-token"
            },
            "args": [
                "/c",
                "bunx",
                "-y",
                "@dsazz/mcp-jira@latest"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_HOST": "https://your-domain.atlassian.net",
                "JIRA_USERNAME": "your-email@example.com",
                "JIRA_API_TOKEN": "your-jira-api-token"
            },
            "args": [
                "-y",
                "@dsazz/mcp-jira@latest"
            ],
            "command": "bunx"
        }
    }
}

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": {
                "JIRA_HOST": "https://your-domain.atlassian.net",
                "JIRA_USERNAME": "your-email@example.com",
                "JIRA_API_TOKEN": "your-jira-api-token"
            },
            "args": [
                "-y",
                "@dsazz/mcp-jira@latest"
            ],
            "command": "bunx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_HOST": "https://your-domain.atlassian.net",
                "JIRA_USERNAME": "your-email@example.com",
                "JIRA_API_TOKEN": "your-jira-api-token"
            },
            "args": [
                "/c",
                "bunx",
                "-y",
                "@dsazz/mcp-jira@latest"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_HOST": "https://your-domain.atlassian.net",
                "JIRA_USERNAME": "your-email@example.com",
                "JIRA_API_TOKEN": "your-jira-api-token"
            },
            "args": [
                "-y",
                "@dsazz/mcp-jira@latest"
            ],
            "command": "bunx"
        }
    }
}

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": {
                "JIRA_HOST": "https://your-domain.atlassian.net",
                "JIRA_USERNAME": "your-email@example.com",
                "JIRA_API_TOKEN": "your-jira-api-token"
            },
            "args": [
                "-y",
                "@dsazz/mcp-jira@latest"
            ],
            "command": "bunx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_HOST": "https://your-domain.atlassian.net",
                "JIRA_USERNAME": "your-email@example.com",
                "JIRA_API_TOKEN": "your-jira-api-token"
            },
            "args": [
                "/c",
                "bunx",
                "-y",
                "@dsazz/mcp-jira@latest"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_HOST": "https://your-domain.atlassian.net",
                "JIRA_USERNAME": "your-email@example.com",
                "JIRA_API_TOKEN": "your-jira-api-token"
            },
            "args": [
                "-y",
                "@dsazz/mcp-jira@latest"
            ],
            "command": "bunx"
        }
    }
}

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": {
                "JIRA_HOST": "https://your-domain.atlassian.net",
                "JIRA_USERNAME": "your-email@example.com",
                "JIRA_API_TOKEN": "your-jira-api-token"
            },
            "args": [
                "-y",
                "@dsazz/mcp-jira@latest"
            ],
            "command": "bunx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_HOST": "https://your-domain.atlassian.net",
                "JIRA_USERNAME": "your-email@example.com",
                "JIRA_API_TOKEN": "your-jira-api-token"
            },
            "args": [
                "/c",
                "bunx",
                "-y",
                "@dsazz/mcp-jira@latest"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_HOST": "https://your-domain.atlassian.net",
                "JIRA_USERNAME": "your-email@example.com",
                "JIRA_API_TOKEN": "your-jira-api-token"
            },
            "args": [
                "-y",
                "@dsazz/mcp-jira@latest"
            ],
            "command": "bunx"
        }
    }
}

From the repository

Create a .env file with the following variables:

JIRA_HOST=https://your-instance.atlassian.net
JIRA_USERNAME=your-email@example.com
JIRA_API_TOKEN=your-jira-api-token-here

> 🔑 Important Note About JIRA API Tokens
>
> - A JIRA API token can be generated at Atlassian API Tokens
> - Tokens may contain special characters, including the = sign
> - Place the token on a single line in the .env file
> - Do not add quotes around the token value
> - Paste the token exactly as provided by Atlassian

For local development and testing:

```bash

bun install

cp .env.example .env

jira_get_issue_comments PROJ-123

`jira_get_assigned_issues`

Retrieves all issues assigned to you. Parameters: None. Returns: Markdown-formatted list of issues.

`jira_get_issue`

Gets detailed information about a specific issue. Parameters: `issueKey`: Issue key (e.g., PD-312). Returns: Markdown-formatted issue details.

`jira_get_issue_comments`

Retrieves comments for a specific issue with configurable options. Parameters: See comment parameters below. Returns: Markdown-formatted comments.

`jira_create_issue`

Create new JIRA issues with comprehensive field support. Parameters: See issue creation parameters. Returns: Markdown-formatted creation result.

`jira_update_issue`

Update existing issues with field changes and status transitions. Parameters: See issue update parameters. Returns: Markdown-formatted update result.

`jira_get_projects`

Retrieve and browse JIRA projects with filtering options. Parameters: See project parameters. Returns: Markdown-formatted project list.

`jira_get_boards`

Get JIRA boards (Scrum/Kanban) with advanced filtering. Parameters: See board parameters. Returns: Markdown-formatted board list.

`jira_get_sprints`

Retrieve sprint information for agile project management. Parameters: See sprint parameters. Returns: Markdown-formatted sprint list.

`jira_add_worklog`

Add time tracking entries to issues. Parameters: See worklog parameters below. Returns: Markdown-formatted worklog result.

`jira_get_worklogs`

Retrieve worklog entries for issues with date filtering. Parameters: See worklog parameters below. Returns: Markdown-formatted worklog list.

`jira_update_worklog`

Update existing worklog entries. Parameters: See worklog parameters below. Returns: Markdown-formatted update result.

`jira_delete_worklog`

Delete worklog entries from issues. Parameters: See worklog parameters below. Returns: Markdown-formatted deletion result.

`jira_get_current_user`

Get current authenticated user information. Parameters: None. Returns: Markdown-formatted user details.

`search_jira_issues`

Search JIRA issues with JQL or helper parameters. Parameters: See search parameters below. Returns: Markdown-formatted search results.

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_HOST": "https://your-domain.atlassian.net",
                "JIRA_USERNAME": "your-email@example.com",
                "JIRA_API_TOKEN": "your-jira-api-token"
            },
            "args": [
                "-y",
                "@dsazz/mcp-jira@latest"
            ],
            "command": "bunx"
        }
    }
}

Linux

{
    "env": {
        "JIRA_HOST": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "your-email@example.com",
        "JIRA_API_TOKEN": "your-jira-api-token"
    },
    "args": [
        "-y",
        "@dsazz/mcp-jira@latest"
    ],
    "command": "bunx"
}

Macos

{
    "env": {
        "JIRA_HOST": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "your-email@example.com",
        "JIRA_API_TOKEN": "your-jira-api-token"
    },
    "args": [
        "-y",
        "@dsazz/mcp-jira@latest"
    ],
    "command": "bunx"
}

Windows

{
    "env": {
        "JIRA_HOST": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "your-email@example.com",
        "JIRA_API_TOKEN": "your-jira-api-token"
    },
    "args": [
        "/c",
        "bunx",
        "-y",
        "@dsazz/mcp-jira@latest"
    ],
    "command": "cmd"
}

🎯 JIRA MCP Server

<p align="center">
<b>A powerful Model Context Protocol (MCP) server that brings Atlassian JIRA integration directly to any editor or application that supports MCP</b>
</p>

</div>

---

✨ Features

- 🎯 Complete JIRA Integration Suite

- 🏗️ Enterprise-Grade Architecture _(New in v0.5.0)_

- 🔍 Powerful Search & Discovery

🆕 What's New in v0.5.0

🏗️ Major Architecture Overhaul

- Complete code reorganization with modular, domain-driven architecture
- HTTP client refactoring with dedicated utility classes for improved reliability
- Critical bug fix for malformed JIRA API URLs that prevented proper communication

🧪 Enhanced Testing & Quality

- 95+ new tests added for HTTP client utilities and edge cases
- 822 total tests ensuring comprehensive coverage and stability
- Zero linting warnings with enhanced Biome integration

🔧 Technical Improvements

- Enhanced error handling with better classification and actionable messages
- Improved logging with structured debug information and performance monitoring
- Type safety enhancements with strict TypeScript checking throughout

🚀 Performance & Reliability

- Optimized HTTP requests with better connection management
- Enhanced error recovery with improved retry logic and timeout handling
- Backward compatibility maintained - seamless upgrade from v0.4.x

🚀 Quick Start

Installation

Add this configuration to your MCP client:

{
  "mcpServers": {
    "JIRA Tools": {
      "command": "bunx",
      "args": ["-y", "@dsazz/mcp-jira@latest"],
      "env": {
        "JIRA_HOST": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "your-email@example.com",
        "JIRA_API_TOKEN": "your-jira-api-token"
      }
    }
  }
}

Development Setup

For local development and testing:

```bash

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

jira_get_assigned_issues

jira_get_issue

jira_get_issue_comments

jira_create_issue

jira_update_issue

jira_get_projects

jira_get_boards

jira_get_sprints

jira_add_worklog

jira_get_worklogs

jira_update_worklog

jira_delete_worklog

jira_get_current_user

search_jira_issues

Claude Desktop / Cursor

Linux

Macos

Windows

🎯 JIRA MCP Server

✨ Features

🆕 What's New in v0.5.0

🏗️ Major Architecture Overhaul

🧪 Enhanced Testing & Quality

🔧 Technical Improvements

🚀 Performance & Reliability

🚀 Quick Start

Installation

Development Setup

Install

More like this

Sequential Thinking

Time

Filesystem

EverArt

Google Drive

GitLab

`jira_get_assigned_issues`

`jira_get_issue`

`jira_get_issue_comments`

`jira_create_issue`

`jira_update_issue`

`jira_get_projects`

`jira_get_boards`

`jira_get_sprints`

`jira_add_worklog`

`jira_get_worklogs`

`jira_update_worklog`

`jira_delete_worklog`

`jira_get_current_user`

`search_jira_issues`