v1.3.0 Open Source MCP Server

Connect your AI coding
assistant to Jira Cloud

One MCP server. Nine tools. Zero context switching.
Search, read, analyze, and comment on Jira issues — directly from your AI editor.

$ npm install -g jira-dev-mcp
npm version GitHub stars MIT License
jira-dev — zsh
$ jira-dev login
Logged in to MyCompany
$ jira_analyze_task(input: "AT-456")
# Task Analysis: AT-456 — Login timeout on mobile
Type: Bug  |  Priority: High  |  Assignee: @kai
Root Cause: Session TTL set to 5min, mobile reconnect takes 8min
Fix: Extend TTL to 30min for mobile user-agent
Impact: Low risk, auth module only
Analysis posted as comment on AT-456
Works with any MCP client
Claude Code
OpenCode
Codex
Any MCP Client

Nine tools, one install

Every Jira workflow your AI assistant needs — from search to analysis — accessible via the Model Context Protocol.

🔍

Search Issues

Natural language queries or raw JQL. Find any issue instantly from your AI assistant.

📋

Read Task Details

Full description, subtasks, changelog, comments, and attachment list — all in one call.

📎

Parse Attachments

Download and parse CSV, XLSX, XLS, and PDF files. Images returned as base64 for AI analysis.

🔐

OAuth 2.0 Login

Browser-based authorization. Tokens auto-refresh. No manual Client ID or Secret needed.

💬

Post & Edit Comments

Add or edit comments with confirmation prompt. Auto-send mode available for CI workflows.

🔄

Smart Retry

Handles 429 and 503 with Retry-After headers and exponential backoff. Bulletproof API calls.

🧪

Analysis Workflow

Type-aware templates for Bug, Story, and Task. Full SOP: explore → plan → implement → comment.

🗺️

Project Mapping

Map Jira project keys to local repo paths. Your AI always knows where to look.

Zero Bloat

Only MCP SDK + Zod. No heavyweight dependencies. Fast startup, minimal footprint.

Up and running in 60 seconds

1

Install

npm i -g jira-dev-mcp

Single global install. Node 18+ required.

2

Login

jira-dev login

Browser opens, authorize, done. Tokens auto-refresh.

3

Use

jira-dev setup

Registers 9 MCP tools into your AI assistant config.

Three commands to Jira-powered AI

Terminal
# Install globally
$ npm install -g jira-dev-mcp
 
# Login to Jira (opens browser)
$ jira-dev login
 
# Register with your AI assistant
$ jira-dev setup

Ready to stop copy‑pasting
Jira tickets?

Give your AI assistant direct access to your entire Jira workspace.

Star on GitHub