MCP Jira Server

by SoorajChandran

3 stars
193 downloads
Not rated
GitHub

About

MCP Jira Server is an MCP (Model Context Protocol) server that integrates with Jira for issue management. It is intended for developers and teams who want to programmatically create, read, update, search, and manage Jira issues and epics via MCP.

Details

Author
SoorajChandran
GitHub stars
3
Downloads
193
Categories
Developer Tools

- Create, read, and update Jira issues
- Search for issues across projects
- Epic management with subtask support
- Personal issue tracking
- Create issues from product requirement documents

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 MCP Jira 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

Clone the repository, install dependencies (Python 3.8+ required), copy .env.example to .env, and fill in your Jira credentials (server URL, email, API token). Then run python src/main.py. The server starts on http://localhost:8000.

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "mcp jira server": {
            "mcp-jira-server-soorajchandran": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    "venv"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-jira-server-soorajchandran": {
        "command": "python",
        "args": [
            "-m",
            "venv",
            "venv"
        ]
    }
}

MCP Jira Server

An MCP server that integrates with Jira for issue management.

Demo video: Watch the demo

Vibecoded by Sooraj Chandran

Features

- Create, read, update Jira issues
- Search issues
- Epic management with subtasks
- Personal issue tracking

Other use cases

- Create issues from PRDs

Prerequisites

- Python 3.8+
- Jira account with API access
- Jira API token

Setup

Option 1:

Clone the repo, ask Cursor (or your IDE) to look at README.md and keep clicking run command until it works.

Option 2:

1. Clone the repository
2. Create a virtual environment:

   python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate

3. Install dependencies:
   pip install -r requirements.txt

4. Copy .env.example to .env and fill in your Jira credentials:
   cp .env.example .env

5. Edit .env with your Jira configuration:
- JIRA_SERVER: Your Jira instance URL
- JIRA_USER: Your Jira email
- JIRA_TOKEN: Your Jira API token
- JIRA_TIMEOUT: API timeout in seconds (default: 30)
- JIRA_MAX_RESULTS: Maximum results per page (default: 50)
- MCP_SERVER_PORT: Server port (default: 8000)

Note:
You'll have to create a static folder inside src.

Running the Server

python src/main.py

The server will start on http://localhost:8000

Security Notes

- Never commit your .env file
- Keep your Jira API token secure
- Use HTTPS in production
- Consider implementing additional authentication for the API endpoints

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.