JIRA MCP Integration MCP Server

A Model-Context-Protocol(MCP) server to allow Claude desktop to create Jira tickets.

Local serverstdioTypeScript

What is the JIRA MCP Integration MCP server?

A Model-Context-Protocol(MCP) server to allow Claude desktop to create Jira tickets. The jira mcp integration mcp server wraps that behind the Model Context Protocol, so an assistant can use it rather than through you.

What it actually does

A Model Context Protocol server for integrating JIRA with Claude. This tool allows Claude to create JIRA tickets directly within your conversations.

The JIRA MCP project is a Node.js/TypeScript application that provides a Model Context Protocol (MCP) server for integrating with JIRA and Zephyr. It allows AI assistants to interact with JIRA for project management and Zephyr for test management through a standardized protocol.

  • Create JIRA tickets with summary, description, acceptance criteria, and issue type
  • Search JIRA tickets using flexible JQL queries or by issue type
  • Assign story points to Story tickets
  • Automatically create linked Test tickets for Stories with points
  • Enhanced error handling with automatic retry for custom field validation issues
  • Updated to use latest JIRA REST API v3 specification (CHANGE-2046 compliant)

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. The configuration blocks on this page cover the common clients.

Configuration

You will need 8 environment variables: JIRA_HOST, JIRA_USERNAME, JIRA_API_TOKEN, JIRA_PROJECT_KEY, AUTO_CREATE_TEST_TICKETS, JIRA_ACCEPTANCE_CRITERIA_FIELD, JIRA_STORY_POINTS_FIELD, JIRA_EPIC_LINK_FIELD. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

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.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the jira mcp integration mcp server does with a few real requests.

When to reach for it

This sits in the planning and project tracking group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. It is maintained by MankowskiNick; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

How to install the JIRA MCP Integration MCP server

{
  "mcpServers": {
    "jira-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/jira-mcp/build/index.js"],
      "env": {
        "JIRA_HOST": "your-site.atlassian.net",
        "JIRA_USERNAME": "your-email@example.com",
        "JIRA_API_TOKEN": "your_api_token",
        "JIRA_PROJECT_KEY": "your_project_key"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
JIRA_HOSTEndpoint or connection string the server talks to.Optional
JIRA_USERNAMEConfiguration value read at startup.Optional
JIRA_API_TOKENCredential the server authenticates with.Yes
JIRA_PROJECT_KEYCredential the server authenticates with.Yes
AUTO_CREATE_TEST_TICKETSConfiguration value read at startup.Optional
JIRA_ACCEPTANCE_CRITERIA_FIELDConfiguration value read at startup.Optional
JIRA_STORY_POINTS_FIELDConfiguration value read at startup.Optional
JIRA_EPIC_LINK_FIELDConfiguration value read at startup.Optional

Frequently asked questions

Generate a token from your Atlassian account at `https://id.atlassian.com/manage/api-tokens`. Use it as the `JIRA_API_TOKEN` environment variable.