Jira Pilot

by Aarul5

4 381 downloads Not rated yet ISC

GitHub Website

About

AI-powered Jira CLI and MCP server for humans and agents manage issues, sprints, boards with interactive wizards, multi-provider AI (OpenAI/Gemini/Anthropic), and an 14-tool MCP server for AI assistants

Details

License: ISC

Explore

| Feature | Description |
|---------|-------------|
| Issue Management | Create, edit, view, list, transition, assign, and comment on issues |
| Work & Time | New: Log work (2h 30m), manage sprints (start/complete), and subtasks |
| Developer Tools | New: Open PRs, save local filters, git branch integration |
| Power Tools | New: Bulk assign, bulk label, bulk transition matching JQL |
| Advanced Data | New: Upload attachments, manage custom fields by alias |
| AI Copilot | Summarize, draft descriptions, suggest actions, review code, plan epics, standup reports |
| Interactive Wizards | Step-by-step prompts with enquirer — no flags required |
| Rich Visualization | Dashboard overview, spinners, and formatted output |
| Export | Output to JSON or Markdown files, pipeable JSON output |

| Feature | Description |
|---------|-------------|
| 14 MCP Tools | list_issues, get_issue, create_issue, update_issue, transition_issue, assign_issue, add_comment, add_worklog, create_subtask, add_attachment, search_users, myself, list_projects, list_sprints |
| LLM-Optimized | Clean, structured JSON responses for efficient token usage |
| Stdio Transport | Standard MCP stdio server — works with any MCP client |

---

> Requires: AI enabled in config setup`.

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 Pilot

Command (node, npx, python, etc.)

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 pilot": {
            "jira-pilot": {
                "command": "npx",
                "args": [
                    "-y",
                    "jira-pilot@latest",
                    "mcp"
                ],
                "env": {
                    "JIRA_URL": "https://your-domain.atlassian.net",
                    "JIRA_EMAIL": "[email protected]",
                    "JIRA_API_TOKEN": "<YOUR_API_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "jira pilot": {
            "jira-pilot": {
                "command": "npx",
                "args": [
                    "-y",
                    "jira-pilot@latest",
                    "mcp"
                ],
                "env": {
                    "JIRA_URL": "https://your-domain.atlassian.net",
                    "JIRA_EMAIL": "[email protected]",
                    "JIRA_API_TOKEN": "<YOUR_API_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "jira pilot": {
            "jira-pilot": {
                "command": "npx",
                "args": [
                    "-y",
                    "jira-pilot@latest",
                    "mcp"
                ],
                "env": {
                    "JIRA_URL": "https://your-domain.atlassian.net",
                    "JIRA_EMAIL": "[email protected]",
                    "JIRA_API_TOKEN": "<YOUR_API_TOKEN>"
                }
            }
        }
    }
}

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 pilot": {
            "jira-pilot": {
                "command": "npx",
                "args": [
                    "-y",
                    "jira-pilot@latest",
                    "mcp"
                ],
                "env": {
                    "JIRA_URL": "https://your-domain.atlassian.net",
                    "JIRA_EMAIL": "[email protected]",
                    "JIRA_API_TOKEN": "<YOUR_API_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "jira pilot": {
            "jira-pilot": {
                "command": "npx",
                "args": [
                    "-y",
                    "jira-pilot@latest",
                    "mcp"
                ],
                "env": {
                    "JIRA_URL": "https://your-domain.atlassian.net",
                    "JIRA_EMAIL": "[email protected]",
                    "JIRA_API_TOKEN": "<YOUR_API_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "jira pilot": {
            "jira-pilot": {
                "command": "npx",
                "args": [
                    "-y",
                    "jira-pilot@latest",
                    "mcp"
                ],
                "env": {
                    "JIRA_URL": "https://your-domain.atlassian.net",
                    "JIRA_EMAIL": "[email protected]",
                    "JIRA_API_TOKEN": "<YOUR_API_TOKEN>"
                }
            }
        }
    }
}

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 pilot": {
            "jira-pilot": {
                "command": "npx",
                "args": [
                    "-y",
                    "jira-pilot@latest",
                    "mcp"
                ],
                "env": {
                    "JIRA_URL": "https://your-domain.atlassian.net",
                    "JIRA_EMAIL": "[email protected]",
                    "JIRA_API_TOKEN": "<YOUR_API_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "jira pilot": {
            "jira-pilot": {
                "command": "npx",
                "args": [
                    "-y",
                    "jira-pilot@latest",
                    "mcp"
                ],
                "env": {
                    "JIRA_URL": "https://your-domain.atlassian.net",
                    "JIRA_EMAIL": "[email protected]",
                    "JIRA_API_TOKEN": "<YOUR_API_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "jira pilot": {
            "jira-pilot": {
                "command": "npx",
                "args": [
                    "-y",
                    "jira-pilot@latest",
                    "mcp"
                ],
                "env": {
                    "JIRA_URL": "https://your-domain.atlassian.net",
                    "JIRA_EMAIL": "[email protected]",
                    "JIRA_API_TOKEN": "<YOUR_API_TOKEN>"
                }
            }
        }
    }
}

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 pilot": {
            "jira-pilot": {
                "command": "npx",
                "args": [
                    "-y",
                    "jira-pilot@latest",
                    "mcp"
                ],
                "env": {
                    "JIRA_URL": "https://your-domain.atlassian.net",
                    "JIRA_EMAIL": "[email protected]",
                    "JIRA_API_TOKEN": "<YOUR_API_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "jira pilot": {
            "jira-pilot": {
                "command": "npx",
                "args": [
                    "-y",
                    "jira-pilot@latest",
                    "mcp"
                ],
                "env": {
                    "JIRA_URL": "https://your-domain.atlassian.net",
                    "JIRA_EMAIL": "[email protected]",
                    "JIRA_API_TOKEN": "<YOUR_API_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "jira pilot": {
            "jira-pilot": {
                "command": "npx",
                "args": [
                    "-y",
                    "jira-pilot@latest",
                    "mcp"
                ],
                "env": {
                    "JIRA_URL": "https://your-domain.atlassian.net",
                    "JIRA_EMAIL": "[email protected]",
                    "JIRA_API_TOKEN": "<YOUR_API_TOKEN>"
                }
            }
        }
    }
}

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 pilot": {
            "jira-pilot": {
                "command": "npx",
                "args": [
                    "-y",
                    "jira-pilot@latest",
                    "mcp"
                ],
                "env": {
                    "JIRA_URL": "https://your-domain.atlassian.net",
                    "JIRA_EMAIL": "[email protected]",
                    "JIRA_API_TOKEN": "<YOUR_API_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "jira pilot": {
            "jira-pilot": {
                "command": "npx",
                "args": [
                    "-y",
                    "jira-pilot@latest",
                    "mcp"
                ],
                "env": {
                    "JIRA_URL": "https://your-domain.atlassian.net",
                    "JIRA_EMAIL": "[email protected]",
                    "JIRA_API_TOKEN": "<YOUR_API_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "jira pilot": {
            "jira-pilot": {
                "command": "npx",
                "args": [
                    "-y",
                    "jira-pilot@latest",
                    "mcp"
                ],
                "env": {
                    "JIRA_URL": "https://your-domain.atlassian.net",
                    "JIRA_EMAIL": "[email protected]",
                    "JIRA_API_TOKEN": "<YOUR_API_TOKEN>"
                }
            }
        }
    }
}

From the repository

- Node.js 20.0.0 or higher

npm install -g jira-pilot

After installing, the jira command is available globally.

---

Before using the tool, set up your credentials. You can get an API Token from Atlassian Account Settings.

jira config setup

You will be prompted for:
1. Jira Site URL — e.g., https://your-company.atlassian.net
2. Email — Your Atlassian account email
3. API Token — The token you generated from Atlassian
4. Enable AI — Toggle AI features on/off
5. AI Provider — Choose between openai, gemini, or anthropic
6. AI API Key — Your API key for the selected provider

jira issue edit PROJ-123 -s "New Summary" --priority High
jira issue edit PROJ-123 -d "New description"
jira issue edit PROJ-123 --custom "points=8"



jira issue assign PROJ-123 -a me       # Assign to yourself

jira issue assign PROJ-123 -a none     # Unassign

jira issue subtask PARENT-123 -s "Implement backend logic" --assignee me

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "jira-pilot", "mcp"]
    }
  }
}

Add to your .vscode/mcp.json or equivalent:

{
  "servers": {
    "jira-pilot": {
      "command": "jira",
      "args": ["mcp"]
    }
  }
}

npx @modelcontextprotocol/inspector node dist/bin/jira.js mcp

npx @modelcontextprotocol/inspector npx -y jira-pilot mcp
```

---

`jira_list_issues`

List Jira issues using JQL. Returns key, summary, status, and assignee for each issue.

`jira_get_issue`

Get full details of a specific Jira issue including summary, description, status, assignee, priority, and comments.

`jira_create_issue`

Create a new Jira issue in a project. Returns the created issue key.

`jira_update_issue`

Update an existing Jira issue. Supports updating summary, description, priority, and assignee.

`jira_transition_issue`

Transition a Jira issue to a new status. First call with only issueKey to see available transitions, then call again with the transitionId.

`jira_assign_issue`

Assign or unassign a Jira issue. Use accountId to assign, or null to unassign.

`jira_add_comment`

Add a comment to a Jira issue.

`jira_search_users`

Search for Jira users by name or email. Returns accountId and displayName.

`jira_myself`

Get details about the current authenticated user.

`jira_list_projects`

List all accessible Jira projects. Returns project key, name, lead, and style.

`jira_list_sprints`

List sprints for a Jira board. Requires a board ID.

`jira_add_worklog`

Log work to a Jira issue.

`jira_create_subtask`

Create a subtask for a parent issue.

`jira_add_attachment`

Attach a file to a Jira issue.

Perform actions on multiple issues matching a JQL query. Great for cleanups or mass updates.

Everything you need to build a fully autonomous Jira agent:

1. jira_list_issues: Search via JQL (supports limit)
2. jira_get_issue: Get full details
3. jira_create_issue: Create new issue (ADF support)
4. jira_update_issue: Update summary, desc, priority, assignee
5. jira_transition_issue: Change status
6. jira_assign_issue: Change assignee
7. jira_add_comment: Add comment
8. jira_add_worklog: Log time
9. jira_create_subtask: Create subtask
10. jira_add_attachment: Upload file (absolute path)
11. jira_search_users: Search for users
12. jira_myself: Get current user details
13. jira_list_projects: List accessible projects
14. jira_list_sprints: List sprints for a board

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "jira pilot": {
            "jira-pilot": {
                "command": "npx",
                "args": [
                    "-y",
                    "jira-pilot@latest",
                    "mcp"
                ],
                "env": {
                    "JIRA_URL": "https://your-domain.atlassian.net",
                    "JIRA_EMAIL": "[email protected]",
                    "JIRA_API_TOKEN": "<YOUR_API_TOKEN>"
                }
            }
        }
    }
}

McpServers

{
    "jira-pilot": {
        "command": "npx",
        "args": [
            "-y",
            "jira-pilot@latest",
            "mcp"
        ],
        "env": {
            "JIRA_URL": "https://your-domain.atlassian.net",
            "JIRA_EMAIL": "[email protected]",
            "JIRA_API_TOKEN": "<YOUR_API_TOKEN>"
        }
    }
}

The AI-Powered Jira CLI and MCP Server for Humans and Agents.

jira-pilot is a next-generation CLI that combines traditional developer tools with modern AI capabilities.

- For Humans: A beautiful, interactive CLI to manage issues, sprints, boards, and code. Now with AI Code Reviews, Epic Planning, Daily Standups, and Natural Language JQL.
- For Agents: A fully compliant Model Context Protocol (MCP) server with 14 tools that lets AI assistants (like Claude Desktop, Cursor, or Gemini) interact with your Jira instance safely.

---

Features at a Glance

👤 Human-Centric Features

| Feature | Description | |---------|-------------| | Issue Management | Create, edit, view, list, transition, assign, and comment on issues | | Work & Time | New: Log work (2h 30m), manage sprints (start/complete), and subtasks | | Developer Tools | New: Open PRs, save local filters, git branch integration | | Power Tools | New: Bulk assign, bulk label, bulk transition matching JQL | | Advanced Data | New: Upload attachments, manage custom fields by alias | | AI Copilot | Summarize, draft descriptions, suggest actions, review code, plan epics, standup reports | | Interactive Wizards | Step-by-step prompts with enquirer — no flags required | | Rich Visualization | Dashboard overview, spinners, and formatted output | | Export | Output to JSON or Markdown files, pipeable JSON output |

🤖 Agentic Features (MCP)

| Feature | Description | |---------|-------------| | 14 MCP Tools | list_issues, get_issue, create_issue, update_issue, transition_issue, assign_issue, add_comment, add_worklog, create_subtask, add_attachment, search_users, myself, list_projects, list_sprints | | LLM-Optimized | Clean, structured JSON responses for efficient token usage | | Stdio Transport | Standard MCP stdio server — works with any MCP client |

---

🚀 Installation

Prerequisites

- Node.js 20.0.0 or higher

Global Install (Recommended)

npm install -g jira-pilot

After installing, the jira command is available globally.

---

⚙️ Configuration

Before using the tool, set up your credentials. You can get an API Token from Atlassian Account Settings.

Initial Setup

jira config setup

Profiles & Management

Manage credentials for multiple environments (e.g., Work vs. Personal, Prod vs. Dev).

jira config view              # Show current configuration (keys are masked)
jira config save work         # Save current creds as profile 'work'
jira config use personal      # Switch to profile 'personal'
jira config profiles          # List all saved profiles
jira config delete-profile work
jira config clear             # Remove all stored credentials

Custom Field Aliases

Define aliases for custom field IDs to make commands easier:

jira config field set points customfield_10011
jira config field list

---

✨ Interactive Experience

Jira Pilot is designed to be fully interactive. You don't need to remember complex flags.

Just run the command, and we'll guide you:

1. Selection: Use arrow keys ↑ ↓ to navigate lists (Projects, Issue Types, Priorities).
2. Filtering: Start typing to filter long lists (e.g., finding a specific assignee).
3. Wizards: Complex flows like creating an issue are broken down into simple steps.
4. Confirmation: Destructive actions prompt for confirmation (y/N).

Example:

jira issue create

? Select Project: PROJ - My Project

? Select Issue Type: Bug

? Summary: Login page crashes

? Priority: High

? Assignee: Me

---

🖥️ Text User Interface (TUI)

Experience Jira in a persistent, interactive terminal interface.

jira tui

Key Features:
Dashboard: Overview of your assigned work.
Issue Navigator: Browse, filter, and view issues.
Kanban Boards: Visualize and manage work on Agile boards.
Interactive: Use arrow keys to navigate rows and columns.

Navigation Shortcuts:
← / → : Switch Tabs (Dashboard, Issues, Boards) or Board Columns
↑ / ↓ : Navigate Lists
Enter : Select / View Details
Esc / b : Back
q : Quit

---

📊 My Dashboard

Start your day with a high-level overview of what's on your plate.

jira dashboard

What you'll see:
👋 Welcome Message: Personalized greeting.
🔥 High Priority: Issues assigned to you that need immediate attention.
📋 Recent Activity: Your recently viewed or updated issues.

🚀 Sprint Status: (If applicable) Active sprint progress.

---

📖 Usage Guide

📋 Issue Management

List Issues

```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

Explore

Setting up with Highlight

From the repository

jira_list_issues

jira_get_issue

jira_create_issue

jira_update_issue

jira_transition_issue

jira_assign_issue

jira_add_comment

jira_search_users

jira_myself

jira_list_projects

jira_list_sprints

jira_add_worklog

jira_create_subtask

jira_add_attachment

Claude Desktop / Cursor

McpServers

Features at a Glance

👤 Human-Centric Features

🤖 Agentic Features (MCP)

🚀 Installation

Prerequisites

Global Install (Recommended)

⚙️ Configuration

Initial Setup

Profiles & Management

Custom Field Aliases

✨ Interactive Experience

🖥️ Text User Interface (TUI)

📊 My Dashboard

📖 Usage Guide

📋 Issue Management

List Issues

More like this

Time

GitLab

Context 7

1Panel

`jira_list_issues`

`jira_get_issue`

`jira_create_issue`

`jira_update_issue`

`jira_transition_issue`

`jira_assign_issue`

`jira_add_comment`

`jira_search_users`

`jira_myself`

`jira_list_projects`

`jira_list_sprints`

`jira_add_worklog`

`jira_create_subtask`

`jira_add_attachment`