Jira

by infinitiq-tech

1 453 downloads Not rated yet MIT

GitHub

About

Integrates with Jira's REST API to enable natural language management of projects, issues, and workflows through tools for searching, creating, and transitioning tickets across both Cloud and Server/Data Center installations.

Details

Repository: InfinitIQ-Tech/mcp-jira
License: MIT

Explore

- Get all accessible Jira projects
- Get details for a specific Jira issue
- Search issues using JQL (Jira Query Language)
- Create new Jira issues
- Add comments to issues
- Get available transitions for an issue
- Transition issues to new statuses

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:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Jira

Command (node, npx, python, etc.) <PATH TO UV>
Arguments
- Argument 1 --directory
- Argument 2 <PATH TO JIRA MCP>
- Argument 3 run
- Argument 4 mcp-server-jira
Environment
- JIRA_TOKEN <TOKEN>
- JIRA_USERNAME <USERNAME>
- JIRA_SERVER_URL https://<ORG>.atlassian.net/
- JIRA_AUTH_METHOD token_auth
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_TOKEN": "<TOKEN>",
                "JIRA_USERNAME": "<USERNAME>",
                "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
                "JIRA_AUTH_METHOD": "token_auth"
            },
            "args": [
                "--directory",
                "<PATH TO JIRA MCP>",
                "run",
                "mcp-server-jira"
            ],
            "command": "<PATH TO UV>"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_TOKEN": "<TOKEN>",
                "JIRA_USERNAME": "<USERNAME>",
                "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
                "JIRA_AUTH_METHOD": "token_auth"
            },
            "args": [
                "--directory",
                "<PATH TO JIRA MCP>",
                "run",
                "mcp-server-jira"
            ],
            "command": "<PATH TO UV>"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_TOKEN": "<TOKEN>",
                "JIRA_USERNAME": "<USERNAME>",
                "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
                "JIRA_AUTH_METHOD": "token_auth"
            },
            "args": [
                "--directory",
                "<PATH TO JIRA MCP>",
                "run",
                "mcp-server-jira"
            ],
            "command": "<PATH TO UV>"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_TOKEN": "<TOKEN>",
                "JIRA_USERNAME": "<USERNAME>",
                "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
                "JIRA_AUTH_METHOD": "token_auth"
            },
            "args": [
                "--directory",
                "<PATH TO JIRA MCP>",
                "run",
                "mcp-server-jira"
            ],
            "command": "<PATH TO UV>"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_TOKEN": "<TOKEN>",
                "JIRA_USERNAME": "<USERNAME>",
                "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
                "JIRA_AUTH_METHOD": "token_auth"
            },
            "args": [
                "--directory",
                "<PATH TO JIRA MCP>",
                "run",
                "mcp-server-jira"
            ],
            "command": "<PATH TO UV>"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_TOKEN": "<TOKEN>",
                "JIRA_USERNAME": "<USERNAME>",
                "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
                "JIRA_AUTH_METHOD": "token_auth"
            },
            "args": [
                "--directory",
                "<PATH TO JIRA MCP>",
                "run",
                "mcp-server-jira"
            ],
            "command": "<PATH TO UV>"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_TOKEN": "<TOKEN>",
                "JIRA_USERNAME": "<USERNAME>",
                "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
                "JIRA_AUTH_METHOD": "token_auth"
            },
            "args": [
                "--directory",
                "<PATH TO JIRA MCP>",
                "run",
                "mcp-server-jira"
            ],
            "command": "<PATH TO UV>"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_TOKEN": "<TOKEN>",
                "JIRA_USERNAME": "<USERNAME>",
                "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
                "JIRA_AUTH_METHOD": "token_auth"
            },
            "args": [
                "--directory",
                "<PATH TO JIRA MCP>",
                "run",
                "mcp-server-jira"
            ],
            "command": "<PATH TO UV>"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_TOKEN": "<TOKEN>",
                "JIRA_USERNAME": "<USERNAME>",
                "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
                "JIRA_AUTH_METHOD": "token_auth"
            },
            "args": [
                "--directory",
                "<PATH TO JIRA MCP>",
                "run",
                "mcp-server-jira"
            ],
            "command": "<PATH TO UV>"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_TOKEN": "<TOKEN>",
                "JIRA_USERNAME": "<USERNAME>",
                "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
                "JIRA_AUTH_METHOD": "token_auth"
            },
            "args": [
                "--directory",
                "<PATH TO JIRA MCP>",
                "run",
                "mcp-server-jira"
            ],
            "command": "<PATH TO UV>"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_TOKEN": "<TOKEN>",
                "JIRA_USERNAME": "<USERNAME>",
                "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
                "JIRA_AUTH_METHOD": "token_auth"
            },
            "args": [
                "--directory",
                "<PATH TO JIRA MCP>",
                "run",
                "mcp-server-jira"
            ],
            "command": "<PATH TO UV>"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_TOKEN": "<TOKEN>",
                "JIRA_USERNAME": "<USERNAME>",
                "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
                "JIRA_AUTH_METHOD": "token_auth"
            },
            "args": [
                "--directory",
                "<PATH TO JIRA MCP>",
                "run",
                "mcp-server-jira"
            ],
            "command": "<PATH TO UV>"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_TOKEN": "<TOKEN>",
                "JIRA_USERNAME": "<USERNAME>",
                "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
                "JIRA_AUTH_METHOD": "token_auth"
            },
            "args": [
                "--directory",
                "<PATH TO JIRA MCP>",
                "run",
                "mcp-server-jira"
            ],
            "command": "<PATH TO UV>"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_TOKEN": "<TOKEN>",
                "JIRA_USERNAME": "<USERNAME>",
                "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
                "JIRA_AUTH_METHOD": "token_auth"
            },
            "args": [
                "--directory",
                "<PATH TO JIRA MCP>",
                "run",
                "mcp-server-jira"
            ],
            "command": "<PATH TO UV>"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_TOKEN": "<TOKEN>",
                "JIRA_USERNAME": "<USERNAME>",
                "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
                "JIRA_AUTH_METHOD": "token_auth"
            },
            "args": [
                "--directory",
                "<PATH TO JIRA MCP>",
                "run",
                "mcp-server-jira"
            ],
            "command": "<PATH TO UV>"
        }
    }
}

From the repository

Prerequisites

- Python 3.9 or higher
- A Jira instance (Cloud, Server, or Data Center)
- uv (optional but recommended for dependency management)

Environment Variables

Configure the server using environment variables:

- JIRA_SERVER_URL: URL of your Jira server
- JIRA_AUTH_METHOD: Authentication method ('basic_auth' or 'token_auth')
- JIRA_USERNAME: Username for basic auth
- JIRA_PASSWORD: Password for basic auth
- JIRA_TOKEN: API token or Personal Access Token

Authentication

The server supports multiple authentication methods:

Activate A Virtual Environment Recommended

Install A Virtual Environment Venv In The Mcp Server Directory python -m venv . Activate The Virtual Environment

source bin/activate

Install Uv If You Don T Have It

pip install uv

Install The Jira Mcp Server

uv pip install mcp-server-jira

Environment File Local Development You can also create a .env file in the root directory with your configuration:

JIRA_SERVER_URL=https://your-jira-instance.atlassian.net
JIRA_AUTH_METHOD=basic_auth
[email protected]
JIRA_TOKEN=your_api_token

Basic Authentication For Jira Server/Data Center with username and password:

bash
JIRA_SERVER_URL="https://jira.example.com"
JIRA_AUTH_METHOD="basic_auth"
JIRA_USERNAME="your_username"
JIRA_PASSWORD="your_password"
```

`get_projects`

Get all accessible Jira projects.

`get_issue`

Get details for a specific Jira issue by key.

`search_issues`

Search for Jira issues using JQL (Jira Query Language).

`create_issue`

Create a new Jira issue.

`add_comment`

Add a comment to a Jira issue.

`get_transitions`

Get available workflow transitions for a Jira issue.

`transition_issue`

Transition a Jira issue to a new status.

1. get_projects: Get all accessible Jira projects
2. get_issue: Get details for a specific Jira issue by key
3. search_issues: Search for Jira issues using JQL
4. create_issue: Create a new Jira issue
5. add_comment: Add a comment to a Jira issue
6. get_transitions: Get available workflow transitions for a Jira issue
7. transition_issue: Transition a Jira issue to a new status

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_TOKEN": "<TOKEN>",
                "JIRA_USERNAME": "<USERNAME>",
                "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
                "JIRA_AUTH_METHOD": "token_auth"
            },
            "args": [
                "--directory",
                "<PATH TO JIRA MCP>",
                "run",
                "mcp-server-jira"
            ],
            "command": "<PATH TO UV>"
        }
    }
}

Linux

{
    "env": {
        "JIRA_TOKEN": "<TOKEN>",
        "JIRA_USERNAME": "<USERNAME>",
        "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
        "JIRA_AUTH_METHOD": "token_auth"
    },
    "args": [
        "--directory",
        "<PATH TO JIRA MCP>",
        "run",
        "mcp-server-jira"
    ],
    "command": "<PATH TO UV>"
}

Macos

{
    "env": {
        "JIRA_TOKEN": "<TOKEN>",
        "JIRA_USERNAME": "<USERNAME>",
        "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
        "JIRA_AUTH_METHOD": "token_auth"
    },
    "args": [
        "--directory",
        "<PATH TO JIRA MCP>",
        "run",
        "mcp-server-jira"
    ],
    "command": "<PATH TO UV>"
}

Windows

{
    "env": {
        "JIRA_TOKEN": "<TOKEN>",
        "JIRA_USERNAME": "<USERNAME>",
        "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
        "JIRA_AUTH_METHOD": "token_auth"
    },
    "args": [
        "--directory",
        "<PATH TO JIRA MCP>",
        "run",
        "mcp-server-jira"
    ],
    "command": "<PATH TO UV>"
}

A Model Context Protocol (MCP) server for interacting with Jira's REST API using the jira-python library. This server integrates with Claude Desktop and other MCP clients, allowing you to interact with Jira using natural language commands.

Features

Installation

Prerequisites

- Python 3.9 or higher
- A Jira instance (Cloud, Server, or Data Center)
- uv (optional but recommended for dependency management)

Activate a virtual environment (recommended)

```bash

No reviews yet — be the first

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

Email sign in

No reviews posted yet.

About

Details

Explore

Setting up with Highlight

From the repository

Prerequisites

Environment Variables

Authentication

Activate A Virtual Environment Recommended

Install A Virtual Environment Venv In The Mcp Server Directory

Activate The Virtual Environment

Install Uv If You Don T Have It

Install The Jira Mcp Server

Environment File Local Development

Basic Authentication

get_projects

get_issue

search_issues

create_issue

add_comment

get_transitions

transition_issue

Claude Desktop / Cursor

Linux

Macos

Windows

Features

Installation

Prerequisites

Activate a virtual environment (recommended)

More like this

Time

Sentry

Github

Git

`get_projects`

`get_issue`

`search_issues`

`create_issue`

`add_comment`

`get_transitions`

`transition_issue`