Jira Communication Server MCP Server

Developer ToolsTypeScript

Interact with Jira issues and projects directly from your AI assistant

Available Tools

execute_jql

Run a JQL query against Jira and return matching issues

jqlnumber_of_results

get_only_ticket_name_and_description

Fetch only the name and description of tickets matching a JQL query

jqlnumber_of_results

create_ticket

Create a new Jira ticket with specified details

project.keysummarydescriptionissuetype.nameparent

list_projects

List available Jira projects

number_of_results

delete_ticket

Delete a specific Jira ticket

issueIdOrKey

edit_ticket

Modify an existing Jira ticket

issueIdOrKeysummarydescriptionlabelsparent

get_all_statuses

Retrieve all available statuses in Jira

number_of_results

assign_ticket

Assign a ticket to a specific user

accountIdissueIdOrKey

query_assignable

Find users who can be assigned to tickets in a project

project_key

add_attachment

Add an attachment to a Jira ticket from a URL

issueIdOrKeyimageUrl

The Jira Communication Server provides a seamless interface between AI assistants and Atlassian Jira. It enables users to execute JQL queries, create and manage tickets, list projects, and handle attachments without leaving their AI assistant interface. This integration streamlines project management workflows by bringing Jira's powerful issue tracking capabilities directly into your conversations.

Overview

The Jira Communication Server allows you to interact with your Jira instance directly through your AI assistant. This integration enables you to perform common Jira operations like querying tickets, creating new issues, and managing projects without switching contexts.

Prerequisites

Before installing the Jira Communication Server, you'll need:

A Jira account with appropriate permissions
An Atlassian API token (generated from https://id.atlassian.com/manage-profile/security/api-tokens)
Node.js installed on your system

Installation

Step 1: Clone the repository

git clone https://github.com/KS-GEN-AI/jira-mcp-server.git
cd jira-mcp-server

Step 2: Install dependencies

npm install

Step 3: Build the server

npm run build

Step 4: Configure your AI assistant

To use with Claude Desktop, you need to add the server configuration to your Claude Desktop config file:

On MacOS: Edit ~/Library/Application Support/Claude/claude_desktop_config.json

On Windows: Edit %LOCALAPPDATA%/Claude/claude_desktop_config.json

Add the following configuration, replacing the placeholder values with your actual Jira credentials:

{
  "mcpServers": {
    "Jira communication server": {
      "command": "node",
      "args": [
        "/PATH_TO_THE_PROJECT/build/index.js"
      ],
      "env": {
        "JIRA_URL": "https://YOUR_INSTANCE.atlassian.net",
        "JIRA_API_MAIL": "your.email@example.com",
        "JIRA_API_KEY": "YOUR_ATLASSIAN_API_TOKEN"
      }
    }
  }
}

Make sure to replace:

/PATH_TO_THE_PROJECT with the absolute path to your cloned repository
YOUR_INSTANCE with your Jira instance name
your.email@example.com with the email associated with your Atlassian account
YOUR_ATLASSIAN_API_TOKEN with your API token from Atlassian

Usage

Once installed, you can use the Jira Communication Server through your AI assistant by asking it to perform Jira-related tasks. For example:

"Find all open bugs in the PROJ project"
"Create a new task in the PROJ project with high priority"
"Show me the details of ticket PROJ-123"
"List all available projects in Jira"

The AI assistant will use the appropriate tools to interact with your Jira instance and return the results.

Troubleshooting

If you encounter issues with the Jira Communication Server:

Verify your Jira credentials are correct in the configuration file
Check that the path to the build/index.js file is correct
Ensure your Jira API token has the necessary permissions
For debugging, you can use the MCP Inspector:

npm run inspector

This will provide a URL to access debugging tools in your browser, which can help identify communication issues between the AI assistant and the Jira server.

Development

For development with auto-rebuild:

npm run watch

This will automatically rebuild the server when you make changes to the source code.