Jira Pilot

@Aarul5

About Jira Pilot

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

#jira #productivity #cli #ai-agent #project-management #atlassian #developer-tools

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "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>"
      }
    }
  }
}

Tools

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

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

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

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

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

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

Add a comment to a Jira issue.

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

Get details about the current authenticated user.

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

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

Log work to a Jira issue.

Create a subtask for a parent issue.

Attach a file to a Jira issue.

Overview

What is Jira Pilot?

Jira Pilot is an AI-powered CLI and Model Context Protocol (MCP) server for Jira. It provides an interactive command-line interface for humans to manage issues, sprints, boards, and code, and a fully compliant MCP server with 14 tools that lets AI assistants interact with your Jira instance.

How to use Jira Pilot?

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.

Key features of Jira Pilot

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

Use cases of Jira Pilot

Manage Jira issues directly from the terminal without a browser
Enable AI assistants to read and write Jira data via MCP
Automate bulk updates to many issues matching a JQL query
Generate daily standup reports from your recent Jira activity
Perform AI-powered code reviews linking PRs to issue requirements

FAQ from Jira Pilot

What runtime does Jira Pilot require?

Node.js 20.0.0 or higher is required.

How do I configure Jira Pilot?

Run jira config setup and provide your Jira site URL, email, API token, and optionally enable AI with a provider (OpenAI, Gemini, Anthropic) and API key.

What transport does the MCP server use?

The MCP server uses stdio transport, compatible with any MCP client.

Can I use Jira Pilot with multiple Jira accounts?

Yes, you can save multiple credential profiles (e.g., work, personal) and switch between them with jira config use <profile>.

Are there any limits or known issues?

The MCP tools require a running Jira instance accessible via API. Bulk operations ask for confirmation before applying changes. AI features require an API key for the chosen provider.

Frequently asked questions