JIRA MCP Server

by rujutaranade

83 downloads
Not rated
GitHub

About

JIRA MCP Server: Essential API Integrations for Technical Program Managers

Details

Author
rujutaranade
Downloads
83
Categories
Developer Tools

- JQL search for issues with pagination and field selection
- Retrieve specific issues by ID or key
- Seamless integration with the Model Context Protocol
- Configurable result limits and response expansion

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name JIRA MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install and run using npx (npx @rujutaranade/likejarvis-jira-mcp-server) or clone the repository, run npm install, copy .env.example to .env, and set the JIRA_INSTANCE_URL, JIRA_API_KEY, and JIRA_USER_EMAIL environment variables. Build with npm run build and start with npm start.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "jira mcp server": {
            "JIRA-MCP-Server": {
                "command": "npx",
                "args": [
                    "@rujutaranade/likejarvis-jira-mcp-server"
                ]
            }
        }
    }
}

McpServers

{
    "JIRA-MCP-Server": {
        "command": "npx",
        "args": [
            "@rujutaranade/likejarvis-jira-mcp-server"
        ]
    }
}

JIRA MCP Server

A TypeScript implementation of a JIRA MCP Server: Essential API Integrations for Technical Program Managers and Engineers

Features

- JQL search functionality
- Issue retrieval by ID or key
- Seamless integration with the Model Context Protocol

Quick Start

Install and run the server using npx:

npx @rujutaranade/likejarvis-jira-mcp-server
npm i likejarvis-jira-mcp-server

Prerequisites

- Node.js (v18 or higher)
- A JIRA instance with API access
- JIRA API key/token

Setup

1. Clone this repository
2. Install dependencies:

   npm install

3. Copy the environment file example and fill in your JIRA credentials:
   cp .env.example .env

4. Edit the .env file with your JIRA instance URL, API key, and user email

Building and Running

Build the TypeScript code:

npm run build

Start the server:

npm start

For development with auto-reload:

npm run dev

Available Tools

1. JQL Search (jql_search)

Perform enhanced JQL (JIRA Query Language) searches to find issues.

Parameters:
- jql (required): The JQL query string
- nextPageToken: Token for pagination
- maxResults: Maximum number of results to return (default: 50)
- fields: List of fields to include in the response
- expand: Additional information to include in the response

2. Get Issue (get_issue)

Retrieve detailed information about a specific issue.

Parameters:
- issueIdOrKey (required): ID or key of the issue
- fields: Fields to include in the response
- expand: Additional information to include in the response
- properties: Properties to include in the response
- failFast: Whether to fail quickly on errors (default: false)

Environment Variables

- JIRA_INSTANCE_URL: The URL of your JIRA instance
- JIRA_API_KEY: Your JIRA API key/token
- JIRA_USER_EMAIL: The email associated with your JIRA account

License

MIT

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.