Jira

by infinitiq-tech

1 stars

453 downloads

Not rated

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

Author: infinitiq-tech
Repository: InfinitIQ-Tech/mcp-jira
GitHub stars: 1
Downloads: 453
License: MIT License
Categories: Productivity, Project Management, Developer Tools, Design, Workplace, AI, Search, Frontend, Communication, Cloud Service

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

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

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

You can also create a.envfile in the root directory with your configuration:

JIRA_SERVER_URL=https://your-jira-instance.atlassian.net JIRA_AUTH_METHOD=basic_auth JIRA_USERNAME=your_email@example.com JIRA_TOKEN=your_api_token

docker build -t mcp-jira . docker run --env-file .env -p 8080:8080 mcp-jira

- Install the server using one of the methods above
- In Claude Desktop:

- Go to Settings -> Developer
- Click Edit Config
- Open the json configuraiton in your editor of choice
- Add the following JSON: (NOTE: The environment variables used are for token Auth and will not work with other authentication methods)

{ "mcpServers": { "jira": { "command": "<PATH TO UV> i.e. /Users/<MYUSERNAME>/.local/bin/uv", "args": ](https://github.com/astral-sh/uv)[ "--directory", "<PATH TO JIRA MCP>", "run", "mcp-server-jira" ], "env": { "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/", "JIRA_AUTH_METHOD": "token_auth", "JIRA_USERNAME": "<USERNAME>", "JIRA_TOKEN": "<TOKEN>" } } } }

- Now you can interact with Jira by asking Claude questions like:

- "Show me all my projects in Jira"
- "Get details for issue PROJECT-123"
- "Create a new bug in the PROJECT with summary 'Fix login issue'"
- "Find all open bugs assigned to me"

The server supports multiple authentication methods:

For Jira Server/Data Center with username and password:

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

JIRA_SERVER_URL="https://your-domain.atlassian.net" JIRA_AUTH_METHOD="basic_auth" JIRA_USERNAME="your_email@example.com" JIRA_TOKEN="your_api_token"

`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>"
}

Jira MCP Server

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

Jump to

Setting up with Highlight

From the repository

Activate A Virtual Environment Recommended

get_projects

get_issue

search_issues

create_issue

add_comment

get_transitions

transition_issue

Claude Desktop / Cursor

Linux

Macos

Windows

Jira MCP Server

Features

Installation

Prerequisites

Activate a virtual environment (recommended)

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7

`get_projects`

`get_issue`

`search_issues`

`create_issue`

`add_comment`

`get_transitions`

`transition_issue`