MCP.so
Sign In

JIRA MCP Integration

@MankowskiNick

Repository

About JIRA MCP Integration

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

Basic information

Category

Version Control

License

MIT

Runtime

node

Transports

stdio

Publisher

MankowskiNick

Config

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

{
  "mcpServers": {
    "jira-mcp": {
      "command": "node",
      "args": [
        "/path/to/project/build/index.js"
      ],
      "env": {
        "JIRA_HOST": "your-site.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "your_api_token",
        "JIRA_PROJECT_KEY": "your_project_key",
        "AUTO_CREATE_TEST_TICKETS": "true",
        "JIRA_ACCEPTANCE_CRITERIA_FIELD": "customfield_10429",
        "JIRA_STORY_POINTS_FIELD": "customfield_10040",
        "JIRA_EPIC_LINK_FIELD": "customfield_10014",
        "JIRA_PRODUCT_FIELD": "customfield_10757",
        "JIRA_PRODUCT_VALUE": "Your Product Name",
        "JIRA_PRODUCT_ID": "12345",
        "JIRA_CATEGORY_FIELD": "customfield_10636",
        "USE_ALTERNATE_CATEGORY": "false",
        "JIRA_DEFAULT_CATEGORY_VALUE": "Default Category",
        "JIRA_DEFAULT_CATEGORY_ID": "12345",
        "JIRA_ALTERNATE_CATEGORY_VALUE": "Alternate Category",
        "JIRA_ALTERNATE_CATEGORY_ID": "67890"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is JIRA MCP Integration?

A Model Context Protocol (MCP) server that integrates JIRA with Claude, enabling AI assistants to create, search, update, and link JIRA tickets, and manage Zephyr test steps directly from conversations.

How to use JIRA MCP Integration?

Install the server via git clone, npm install, and npm run build (or npm run build-win on Windows). Add a configuration entry to your Claude desktop config file (claude_desktop_config.json) with the command "node", args pointing to the built index.js, and environment variables for your JIRA instance (host, email, API token, project key). After restarting Claude, the server’s tools are available for use.

Key features of JIRA MCP Integration

  • 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 and auto‑create linked Test tickets
  • Update existing JIRA tickets with new field values
  • Link JIRA tickets together with specified relationship types
  • Retrieve and add test steps for Zephyr test tickets

Use cases of JIRA MCP Integration

  • Create a new JIRA bug or story directly from a Claude conversation
  • Search for open bugs by issue type and priority without leaving the chat
  • Update a ticket’s sprint or story points during a planning discussion
  • Automatically generate a linked Test ticket when a Story is created with points
  • Link related tickets (e.g., duplicate, blocks) as part of a workflow

FAQ from JIRA MCP Integration

How do I get a JIRA API token?

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

What environment variables are required?

The four required variables are JIRA_HOST, JIRA_USERNAME, JIRA_API_TOKEN, and JIRA_PROJECT_KEY. Optional variables control custom fields, Zephyr integration, and test ticket creation.

Can I use this server with Zephyr for test management?

Yes. Set the Zephyr environment variables (ZAPI_BASE_URL, ZAPI_ACCESS_KEY, ZAPI_SECRET_KEY, ZAPI_JWT_EXPIRE_SEC) to enable the get-test-steps and add-test-steps tools.

How do I find custom field IDs for my JIRA instance?

Open a ticket in JIRA, press F12 to open developer tools, go to the Network tab, refresh the page, and look for a request to issue/[ISSUE-KEY]. The response contains custom field IDs. Alternatively, call GET /rest/api/3/field on your JIRA instance.

What authentication does the server use?

It uses HTTP Basic Authentication with a JIRA API token. The username is your email and the password is the token provided in the JIRA_API_TOKEN environment variable.

Comments

More Version Control MCP servers

GitLab MCP Server

yoda-digital

Production-grade GitLab MCP server with 86 tools — full GitLab control from any AI agent (Claude, Cursor, Zed).

59

MCP GitHub Project Manager

kunwarVivek

a mcp server to manage github project's functionality

91

Gerrit Review MCP Server

cayirtepeomer

This MCP server provides integration with Gerrit code review system, allowing AI assistants to review code changes and their details through a simple interface.

37

AIO-MCP Server

athapong

🚀 All-in-one MCP server with AI search, RAG, and multi-service integrations (GitLab/Jira/Confluence/YouTube) for AI-enhanced development workflows. Folk from https://github.com/nguyenvanduocit/all-in-one-model-context-protocol

36

mcp-github-trending MCP Server

hetaoBackend

MCP server for getting github trending repos & developers

53