✨ v2.0.0 - Complete Jira CLI Integration

Jira Automation
via AI

Complete Jira CLI integration through Model Context Protocol. Control Jira with natural language - 48 powerful tools at your command.

⭐ Get Started 📦 Quick Install 🌐 Live Demo
48
AI Tools
15
Categories
100%
CLI Parity
v2.0
Latest

What's New in v2.0

⏱️

Worklog Management

Add time entries, track work hours, and generate comprehensive worklog reports

🔗

Issue Linking

Create relationships between issues: blocks, relates to, duplicates

🏃

Sprint Operations

Add/remove issues from sprints, track sprint progress, manage backlogs

🏷️

Label Management

Organize issues with labels, batch updates, smart categorization

📊

Data Export

Export to CSV/JSON with custom JQL queries for analysis

🤖

AI-Powered

Natural language commands via Model Context Protocol

Quick Installation

1
Get API Token
Visit Atlassian API Tokens and create a new token
2
Install Dependencies
Run npm install in the project directory
3
Configure MCP
Add configuration to your MCP config file (see below)
4
Start Using
Restart your AI assistant and start automating Jira!
.cursor/mcp-config.json (NPM Package)
1 2 3 4 5 6 7 8 9 10 11 12 13 14 
{
  "mcpServers": {
    "JiraMCP": {
      "type": "stdio",
      "command": "npx",
      "args": ["@garyw/jira-mcp-server@latest"],
      "env": {
        "JIRA_BASE_URL": "https://yourcompany.atlassian.net",
        "JIRA_USERNAME": "your@email.com",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

Or use a local installation:

.cursor/mcp-config.json (Local Path)
1 2 3 4 5 6 7 8 9 10 11 12 13 14 
{
  "mcpServers": {
    "JiraMCP": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/jira-mcp-server/src/index.js"],
      "env": {
        "JIRA_BASE_URL": "https://yourcompany.atlassian.net",
        "JIRA_USERNAME": "your@email.com",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

IDE Configuration

Configure the Jira MCP server in your favorite environment. These quick-start templates cover the most common IDEs and assistants so you can connect in seconds.

Install the Continue AI copilot for VS Code and drop this snippet into .continue/config.json (or use the Continue settings UI) to register the MCP server.

.continue/config.json
1 2 3 4 5 6 7 8 9 10 11 12 13 
{
  "mcpServers": {
    "jira-mcp": {
      "command": "node",
      "args": ["${workspaceFolder}/src/index.js"],
      "env": {
        "JIRA_BASE_URL": "https://yourcompany.atlassian.net",
        "JIRA_USERNAME": "your@email.com",
        "JIRA_API_TOKEN": "${env:JIRA_API_TOKEN}"
      }
    }
  }
}

Create or update .cursor/mcp-config.json in your workspace. Cursor reloads the server automatically on save.

.cursor/mcp-config.json
1 2 3 4 5 6 7 8 9 10 11 12 13 
{
  "mcpServers": {
    "JiraMCP": {
      "type": "stdio",
      "command": "npx",
      "args": ["@garyw/jira-mcp-server@latest"],
      "env": {
        "JIRA_BASE_URL": "https://yourcompany.atlassian.net",
        "JIRA_USERNAME": "your@email.com",
        "JIRA_API_TOKEN": "${env:JIRA_API_TOKEN}"
      }
    }
  }
}

Add a server entry in ~/.config/JetBrains/ai-assistant/mcp.json (Linux/macOS) or %APPDATA%\JetBrains\ai-assistant\mcp.json on Windows.

ai-assistant/mcp.json
1 2 3 4 5 6 7 8 9 10 11 12 13 
{
  "servers": {
    "jira": {
      "transport": "stdio",
      "command": "node",
      "args": ["/path/to/jira-mcp-server/src/index.js"],
      "env": {
        "JIRA_BASE_URL": "https://yourcompany.atlassian.net",
        "JIRA_USERNAME": "your@email.com",
        "JIRA_API_TOKEN": "${env:JIRA_API_TOKEN}"
      }
    }
  }
}

Register the server in claude_desktop_config.json (Desktop) or the browser MCP settings panel.

claude_desktop_config.json
1 2 3 4 5 6 7 8 9 10 11 12 13 
{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["@garyw/jira-mcp-server@latest"],
      "env": {
        "JIRA_BASE_URL": "https://yourcompany.atlassian.net",
        "JIRA_USERNAME": "your@email.com",
        "JIRA_API_TOKEN": "${env:JIRA_API_TOKEN}"
      }
    }
  }
}

Usage Examples

Click to expand and see real-world examples

💡 What You Can Do
▼
⏱️ Time Tracking
Log work hours with comments
"Log 4h on PROJ-123"
🏃 Sprint Management
Batch add/remove issues
"Add PROJ-100 to Sprint 42"
🔗 Issue Linking
Create dependencies
"PROJ-200 blocks PROJ-201"
🏷️ Label Management
Organize with labels
"Add labels frontend, urgent"
📊 Data Export
Export to CSV/JSON
"Export all bugs to CSV"
🔍 JQL Queries
Advanced filtering
"Show high priority bugs"
👁️ Watch & Vote
Get notifications
"Watch and vote PROJ-456"
📎 Attachments
Upload files
"Attach screenshot.png"
📝 Subtasks
Break down work
"Create subtask for PROJ-100"
🚀 Versions
Release management
"Create version 2.0.0"
💬 Comments
Collaborate easily
"Add comment to PROJ-789"
🔄 Transitions
Change status
"List transitions for PROJ-100"
🤖 Natural Language Control
Just tell the AI what you want to do in plain English. No need to remember command syntax or API endpoints.

Powerful JQL Queries

Full JQL support for advanced filtering and reporting

🔍 What You Can Query
👤 User Filters
• My open issues
• Unassigned issues
• Team workload
🐛 Issue Types
• All bugs
• Stories & epics
• Subtasks
⚡ Priority
• Critical issues
• High priority
• By severity
📅 Time-based
• Recently created
• Overdue items
• Updated today
🏃 Sprint & Status
• Current sprint
• Blocked items
• Done this week
🏷️ Organization
• By labels
• By components
• Without epic
📎 Attachments
• With files
• Screenshots
• Documents
🔗 Relations
• Linked issues
• Dependencies
• Parent/child
💡 Example: assignee = currentUser() AND status != Done AND priority = High

48 Powerful Tools

🎯

Issue Management

15
List • Get • Create • Update • Delete • Clone • Link • Watch • Unwatch • Vote • Unvote • Transitions • Subtasks • Export
⏱️

Time Tracking

2
Add Worklog • List Worklogs
🏷️

Labels & Components

4
Add Labels • Remove Labels • List Components • Add Components
🏃

Sprint Operations

4
List Sprints • Sprint Issues • Add to Sprint • Remove from Sprint
🔍

Search & Reports

5
JQL Query • Bug Reports • Recent Issues • List Projects • List Epics
📎

Attachments

2
Add Attachment • List Attachments
🎨

Boards & Epics

4
List Boards • Board Issues • Epic Issues • Add to Epic
🚀

Versions & Releases

2
Create Version • List Versions
💬

Comments

2
Add Comment • List Comments
🔧

Utilities

3
Open in Browser • User Info • Server Info
📊

Custom Reports

5
PowerShell Scripts • Bug Analytics • Sprint Reports • Worklog Analysis • Custom Queries

🚀 Ready to Automate?

Join developers using AI to streamline Jira workflows. Complete CLI integration, natural language control, zero hassle.

⭐ Star on GitHub 📚 Read Full Docs 🤝 Contribute