jira-mcp

dhruv110795/jira-mcp

3.2

If you are the rightful owner of jira-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This is a Multi-Channel Platform (MCP) server for integrating with Jira, enabling automation and connectivity with other systems.

Tools

  1. get_issue

    Retrieve details of a specific Jira issue.

  2. search_issues

    Search for Jira issues based on JQL queries.

  3. create_issue

    Create a new Jira issue.

  4. update_issue

    Update an existing Jira issue.

  5. transition_issue

    Transition a Jira issue to a different status.

Jira MCP Server

This is a Multi-Channel Platform (MCP) server for integrating with Jira. It exposes Jira operations (search, get, create, update, transition, comment, etc.) as MCP tools, making it easy to automate and connect Jira with other systems.

Prerequisites

  • Python 3.8+
  • Jira Cloud account (with API token)
  • fastMCP (installed via requirements.txt)
  • (Optional) OpenWebUI for UI integration

Setup Instructions

  1. Clone the repository

    git clone <your-repo-url>
cd jira_mcp

  2. Install dependencies

    pip install -r requirements.txt

  3. Configure Jira credentials Create a .env file in the project root (or set environment variables):

    JIRA_BASE_URL=https://your-domain.atlassian.net
JIRA_USER=your-email@example.com
JIRA_API_TOKEN=your-api-token

    Or, you can use a config.yaml for fastMCP:

    JIRA_BASE_URL: "https://your-domain.atlassian.net"
JIRA_USER: "your-email@example.com"
JIRA_API_TOKEN: "your-api-token"

  4. Run the MCP server

    python service.py

    Or, if using fastMCP CLI:

    fastmcp run service.py --config config.yaml

  5. Test the server

    • Use the MCP CLI or HTTP API to call tools like get_issue, search_issues, etc.
    • Example (CLI): 
      fastmcp actions call get_issue --issue_key EC-123

Running and Inspecting the MCP Server

Running the MCP Server

You can run the MCP server using the following command:

uvx mcpo --port 8080 -- uv run service.py
  • This starts the MCP server on port 8080 using the mcpo tool (part of the fastMCP ecosystem).
  • Your Jira tools will be available over HTTP and/or other transports as configured.
  • Make sure your environment variables or config file are set up before running this command.

Inspecting the MCP Tool (Development)

To interactively inspect and test your MCP tools, use the MCP Inspector:

mcp dev service.py
  • This launches the MCP Inspector for your plugin.
  • You can interactively test, debug, and view schemas for your tools (like get_issue, search_issues, etc.).
  • Restart the inspector after code changes to see updates.

Integration with OpenWebUI

Once your server is running and tested, you can point OpenWebUI's MCP tool configuration to http://localhost:8080 (or your chosen port) to enable Jira automation and workflows from the UI.

Feel free to fork, contribute, or open issues for improvements!