Jira MCP Server

Jira CLI as an MCP

Local serverstdioPython

What is the Jira MCP server?

Jira CLI as an MCP. Exposed over MCP by the jira mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.

What it actually does

A Model Context Protocol (MCP) server that wraps the Jira CLI tool, exposing Jira commands through MCP resources, tools, and prompts for AI assistant integration.

  • MCP Resources — Access Jira data through standardized URL endpoints
  • MCP Tools — Execute Jira commands (create issues, edit, assign, etc.)
  • MCP Prompts — Use templates for common Jira workflows
  • Authentication — Uses existing Jira CLI authentication
  • Project Configuration — Customize default project and config

Its toolset

Everything the assistant can do here goes through one of these:

  • create_issue — Create a new Jira issue
  • edit_issue — Edit an existing Jira issue
  • assign_issue — Assign issue to a user
  • move_issue — Move/transition issue to new status
  • add_comment — Add comment to issue
  • search_issues_tool — Search issues with flexible criteria
  • clone_issue — Clone an existing issue
  • link_issues — Link two issues
  • create_epic — Create a new epic
  • add_to_sprint — Add issues to sprint

Configuration

You will need 2 environment variables: JIRA_PROJECT, JIRA_CONFIG_FILE. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

  • Python 3.11+ - Jira CLI installed and configured - Access to a Jira instance

Adding it to your client

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client.

When to reach for it

Among the planning and project tracking options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Jira's toolset — create_issue, edit_issue, assign_issue and 7 more — is a fair guide to whether it matches your workflow.

This entry was verified against Jira's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 10 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Jira.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the jira mcp server does with a few real requests.

Available tools

ToolWhat it does
create_issueCreate a new Jira issue
edit_issueEdit an existing Jira issue
assign_issueAssign issue to a user
move_issueMove/transition issue to new status
add_commentAdd comment to issue
search_issues_toolSearch issues with flexible criteria
clone_issueClone an existing issue
link_issuesLink two issues
create_epicCreate a new epic
add_to_sprintAdd issues to sprint

Configuration

  • Python 3.11+ - Jira CLI installed and configured - Access to a Jira instance
VariableDescriptionRequired
JIRA_PROJECTConfiguration value read at startup.Optional
JIRA_CONFIG_FILEConfiguration value read at startup.Optional

Example prompts to try

  • Use Jira to create issue.
  • Use Jira to edit issue.
  • Use Jira to assign issue.

Frequently asked questions

It connects Jira to MCP-compatible AI assistants such as Claude and Cursor, exposing 10 tools (create_issue, edit_issue, assign_issue, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Jira directly.