Jira Skill
by
Provides CLI tools for Jira issue management, worklogs, sprints, boards, and wiki markup via AI agent skills, supporting both Server/DC and Cloud deployments.
Jira Skill Overview
What is Jira Skill about?
Jira Skill offers two Agent Skills—jira-communication and jira-syntax—that expose the full Jira REST API through Python‑based command‑line scripts. The skills are auto‑discovered by Claude Code and other Agent‑Skills‑compatible AI agents, enabling natural‑language driven interactions with Jira.
How to use Jira Skill?
- Install the skill (preferred with npx):
npx skills add https://github.com/netresearch/jira-skill --skill jira-communication npx skills add https://github.com/netresearch/jira-skill --skill jira-syntax - Configure credentials by running
scripts/core/jira-setup.pyor creating a~/.env.jirafile withJIRA_URL,JIRA_USERNAME, andJIRA_API_TOKEN. - Execute commands from the
skills/jira-communication/directory (or prefix the path). Example:uv run scripts/core/jira-search.py query "project = PROJ AND status = 'In Progress'" --json - Use the same pattern for issue retrieval, creation, worklog management, board and sprint operations, etc.
Key Features of Jira Skill
- Zero MCP overhead – scripts run directly via Bash/uv, no Docker needed.
- Full API coverage – creates, reads, updates, comments, transitions, worklogs, attachments, boards, sprints, fields, and users.
- Cross‑platform compatibility – works with Claude Code, Cursor, GitHub Copilot, and any Agent‑Skills‑compliant AI.
- Server & Cloud support – handles both Jira Data Center/Server and Jira Cloud authentication models.
- Dry‑run mode – preview changes before applying them.
- Multiple installation paths – marketplace, npx, direct Git clone, Composer, npm.
Use Cases of Jira Skill
| Scenario | How Jira Skill Helps |
|---|---|
| Automated ticket triage | AI agent queries open bugs, adds labels, and assigns owners using natural‑language prompts. |
| Sprint planning | List active sprints, fetch backlog items, and move issues into a sprint programmatically. |
| Time tracking | Log work hours from chat interactions or scripts without opening the UI. |
| Documentation generation | Validate and render Jira wiki markup through the jira-syntax skill. |
| CI/CD integration | Trigger issue creation or status updates from pipelines via the CLI scripts. |
FAQ from the Jira Skill
Q: Do I need Docker to run the skills?
A: No. The scripts run directly with Python (recommended uv) or via the npx installer.
Q: Which Python versions are supported? A: 3.10 – 3.13 (as indicated by the badge).
Q: How are credentials handled?
A: Create a ~/.env.jira file or run scripts/core/jira-setup.py for interactive setup. Environment variables JIRA_URL, JIRA_USERNAME, and JIRA_API_TOKEN are read by the scripts.
Q: Can I use the skill with other AI agents? A: Yes. Any agent that implements the Agent Skills open standard can discover and invoke the skills.
Q: What is the difference between jira-communication and jira-syntax?
A: jira-communication provides API‑based operations; jira-syntax offers wiki markup validation, templates, and rendering.
Q: How do I run a dry‑run for a transition?
A: Append --dry-run to the transition command, e.g., uv run scripts/workflow/jira-transition.py do PROJ-123 "In Progress" --dry-run.
Q: What if I get "uv not found"?
A: Install uv with pip install uv or use a standard Python virtual environment.
Jira Skill's README
Jira Integration Plugin for Claude Code
A Claude Code plugin providing comprehensive Jira integration through two specialized skills.
Plugin Structure
| Skill | Purpose |
|---|---|
jira-communication |
API operations via Python CLI scripts |
jira-syntax |
Wiki markup syntax, templates, validation |
Each skill has its own SKILL.md with trigger conditions and usage instructions. Claude Code auto-discovers and activates skills based on context.
🔌 Skill Compatibility
The skills contained in this plugin follow the Agent Skills open standard originally developed by Anthropic and released for cross-platform use.
Supported Platforms:
- ✅ Claude Code (Anthropic)
- ✅ Cursor
- ✅ GitHub Copilot
- ✅ Other skills-compatible AI agents
Skills are portable packages of procedural knowledge that work across any AI agent supporting the Agent Skills specification.
Features
- Zero MCP overhead - Scripts invoked via Bash, no tool descriptions loaded
- Fast execution - No Docker container spin-up
- Full API coverage - All common Jira operations supported
- Jira Server/DC + Cloud - Works with both deployment types
Installation
Marketplace (Recommended)
Add the Netresearch marketplace once, then browse and install skills:
# Claude Code
/plugin marketplace add netresearch/claude-code-marketplace
npx (skills.sh)
Install with any Agent Skills-compatible agent:
npx skills add https://github.com/netresearch/jira-skill --skill jira-communication
npx skills add https://github.com/netresearch/jira-skill --skill jira-syntax
Download Release
Download the latest release and extract to your agent's skills directory.
Git Clone
git clone https://github.com/netresearch/jira-skill.git
Composer (PHP Projects)
composer require netresearch/jira-skill
Requires netresearch/composer-agent-skill-plugin.
npm (Node Projects)
npm install --save-dev \
@netresearch/agent-skill-coordinator \
github:netresearch/jira-skill
Requires @netresearch/agent-skill-coordinator, which discovers the skill in node_modules and registers it in AGENTS.md via a postinstall hook. For pnpm, also allowlist the coordinator's postinstall:
{
"pnpm": {
"onlyBuiltDependencies": ["@netresearch/agent-skill-coordinator"]
}
}
Quick Start
Note: Run commands from
skills/jira-communication/, or prefix paths withskills/jira-communication/from the repo root.
# Search issues
uv run scripts/core/jira-search.py query "project = PROJ AND status = 'In Progress'"
# Get issue details
uv run scripts/core/jira-issue.py get PROJ-123
# Add worklog
uv run scripts/core/jira-worklog.py add PROJ-123 "2h 30m" -c "Code review"
# Create issue
uv run scripts/workflow/jira-create.py issue PROJ "Fix bug" --type Bug --priority High
Available Scripts
Core Operations (scripts/core/)
| Script | Commands | Usage |
|---|---|---|
jira-setup.py |
(default) | Interactive credential setup |
jira-validate.py |
(default) | Validate environment setup |
jira-issue.py |
get, update | Get and update issues |
jira-search.py |
query | JQL search |
jira-worklog.py |
add, list | Time tracking |
jira-attachment.py |
download | Download issue attachments |
Workflow Operations (scripts/workflow/)
| Script | Commands | Usage |
|---|---|---|
jira-create.py |
issue | Create new issues |
jira-transition.py |
list, do | Change issue status |
jira-comment.py |
add, list | Issue comments |
jira-sprint.py |
list, issues, current | Sprint operations |
jira-board.py |
list, issues | Board operations |
Utility Operations (scripts/utility/)
| Script | Commands | Usage |
|---|---|---|
jira-fields.py |
search, list | Find field IDs |
jira-user.py |
me, get | User information |
jira-link.py |
create, list-types | Issue linking |
Common Options
All scripts support:
--json- Output as JSON--quiet/-q- Minimal output--env-file PATH- Custom environment file--debug- Show detailed errors--help- Show command help
Write operations also support:
--dry-run- Preview changes without executing
Script Usage Examples
Search and Filter
# Find open bugs in project
uv run scripts/core/jira-search.py query "project = PROJ AND type = Bug AND status != Done"
# Find my assigned issues
uv run scripts/core/jira-search.py query "assignee = currentUser()"
# Output as JSON for processing
uv run scripts/core/jira-search.py query "project = PROJ" --json --max-results 100
Issue Management
# Get issue details
uv run scripts/core/jira-issue.py get PROJ-123
# Update issue fields (dry-run first)
uv run scripts/core/jira-issue.py update PROJ-123 --labels "urgent,backend" --dry-run
# Create new issue
uv run scripts/workflow/jira-create.py issue PROJ "Implement feature X" --type Story --priority Medium
Time Tracking
# Log time worked
uv run scripts/core/jira-worklog.py add PROJ-123 "2h 30m" -c "Implemented core logic"
# View worklogs
uv run scripts/core/jira-worklog.py list PROJ-123
Workflow Transitions
# List available transitions
uv run scripts/workflow/jira-transition.py list PROJ-123
# Transition issue (dry-run first)
uv run scripts/workflow/jira-transition.py do PROJ-123 "In Progress" --dry-run
# Execute transition
uv run scripts/workflow/jira-transition.py do PROJ-123 "In Progress"
Comments
# Add comment
uv run scripts/workflow/jira-comment.py add PROJ-123 "Investigation complete - root cause identified"
# List recent comments
uv run scripts/workflow/jira-comment.py list PROJ-123 --limit 5
Sprint & Board Operations
# List boards for project
uv run scripts/workflow/jira-board.py list --project PROJ
# Get board issues
uv run scripts/workflow/jira-board.py issues 42
# List sprints
uv run scripts/workflow/jira-sprint.py list 42 --state active
# Get sprint issues
uv run scripts/workflow/jira-sprint.py issues 123
# Get current sprint
uv run scripts/workflow/jira-sprint.py current 42
Utility Operations
# Search for custom fields
uv run scripts/utility/jira-fields.py search "story points"
# List all custom fields
uv run scripts/utility/jira-fields.py list --type custom
# Get current user info
uv run scripts/utility/jira-user.py me
# List available link types
uv run scripts/utility/jira-link.py list-types
# Create issue link
uv run scripts/utility/jira-link.py create PROJ-123 PROJ-456 --type "Blocks" --dry-run
Related Skills
- jira-syntax - Jira wiki markup validation and templates (unchanged)
Troubleshooting
"uv not found"
Install uv:
pip install uv
"Environment file not found"
Create ~/.env.jira with your credentials.
"Authentication failed"
- Verify JIRA_URL is correct
- For Cloud: JIRA_USERNAME is your email
- For Server/DC: Use JIRA_PERSONAL_TOKEN instead
- Regenerate your API token if expired
Import errors when running scripts
Run scripts from the skill directory:
cd skills/jira-communication
uv run scripts/core/jira-issue.py get PROJ-123
License
MIT
Credits
Developed and maintained by Netresearch DTT GmbH.
Made with ❤️ for Open Source by Netresearch
Jira Skill Reviews
Login Required
Please log in to share your review and rating for this MCP.
Similar MCP Servers like Jira Skill
Explore related MCPs that share similar capabilities and solve comparable challenges
Activepieces
by activepieces
A self‑hosted, open‑source platform that provides a no‑code builder for creating, versioning, and running AI‑driven automation workflows. Pieces are TypeScript‑based plugins that become MCP servers, allowing direct consumption by large language models.
Skyvern
Officialby Skyvern-AI
Automates browser‑based workflows by leveraging large language models and computer‑vision techniques, turning natural‑language prompts into fully functional web interactions without writing custom scripts.
BlenderMCP
Officialby ahujasid
Enables Claude AI to control Blender for prompt‑assisted 3D modeling, scene creation, and manipulation via a socket‑based Model Context Protocol server.
Pipedream
by PipedreamHQ
Connect APIs quickly with a free, hosted integration platform that enables event‑driven automations across 1,000+ services and supports custom code in Node.js, Python, Go, or Bash.
Inbox Zero
by elie222
Organizes email inbox, drafts replies in the user's tone, tracks follow‑ups, and provides analytics to achieve inbox zero quickly.
Cursor Talk To Figma
by grab
Enables Cursor AI to read and programmatically modify Figma designs through a Model Context Protocol integration.
Windows MCP
by CursorTouch
Enables AI agents to control the Windows operating system, performing file navigation, application launching, UI interaction, QA testing, and other automation tasks through a lightweight server.
Ableton MCP
by ahujasid
Enables Claude AI to control Ableton Live in real time, allowing AI‑driven creation, editing, and playback of tracks, clips, instruments, and effects through a socket‑based server.
N8n Mcp Server
by leonardsellem
Provides tools and resources to enable AI assistants to manage and execute n8n workflows via natural language commands.