Jira MCP Server logo

Jira MCP Server

by maximepeabody

The Jira MCP Server is a Simple Model Context Protocol (MCP) server that enables AI assistants to interact with Jira. It allows AI to perform actions like fetching tickets, adding comments, and updating status.

View on GitHub

Last updated: N/A

Jira MCP Server

A Simple Model Context Protocol (MCP) server that allows AI assistants to interact with Jira. This server enables AI to perform actions like:

  • Fetching user's assigned tickets
  • Adding comments to tickets
  • Getting available status transitions
  • Updating ticket status

Prerequisites

  • Docker
  • Jira account with API access
  • Environment variables configured (see below)

Environment Variables

Create a .env file in the root directory with the following:

JIRA_SERVER=https://yourcompany.atlassian.net
[email protected]
JIRA_API_KEY=yourapikey
JIRA_PROJECT_KEY=yourprojectkey

Get your API key from: https://id.atlassian.com/manage-profile/security/api-tokens

Running Locally

Option 1: Using Docker

# Build and run with Docker
chmod +x run_docker_locally.sh
./run_docker_locally.sh

Option 2: Using Python

  1. Install dependencies:
pip install -r requirements.txt
  1. Run the server:
uvicorn src.server:app --reload

This will start the server on http://localhost:8000.

Using the MCP Server

The MCP server is exposed at http://localhost:8000/mcp.