Jira Pilot
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
- Author
- Aarul5
- GitHub stars
- 4
- Downloads
- 381
- Categories
- Productivity, Project Management, AI, Automation, Developer Tools
Jump to
- Interactive CLI with wizards, filtering, and rich visualization
- 14 MCP tools for AI agents (list, create, update issues, etc.)
- AI features: summarize, draft, suggest, code review, epic planning, standup
- Bulk operations: transition, assign, label multiple issues at once
- Sprint management, worklogs, subtasks, and attachments
- Custom field aliases, profiles, saved filters, and export to JSON/Markdown
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 PilotCommand (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
From the repository
Install globally with npm install -g jira-pilot, then run jira config setup to configure credentials, site URL, and optional AI provider. Use the jira command for interactive CLI workflows or connect the MCP server via stdio transport to any MCP client like Claude Desktop.
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.
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": "your-email@example.com",
"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": "your-email@example.com",
"JIRA_API_TOKEN": "<YOUR_API_TOKEN>"
}
}
}Jira Pilot ✈️
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 higherGlobal 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
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
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
```bashSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
