redhat-ai-tools/jira-mcp

A containerized Python MCP server for Cursor to provide access to Jira.

[!IMPORTANT] This project is experimental and was initially created as a learning exercise. Be aware there are more capable and mature Jira MCP solutions available, such as sooperset/mcp-atlassian, and Atlassian's own MCP Server.

See also redhat-ai-tools/jira-mcp-snowflake which provides another way to access Red Hat Jira data.

Prerequisites

  • podman - Install with sudo dnf install podman (Fedora/RHEL) or brew install podman (macOS)
  • make - Usually pre-installed on most systems

Quick Start

  1. Get the code
git clone git@github.com:redhat-ai-tools/jira-mcp.git
cd jira-mcp
  1. Build the image & configure Cursor This also creates a ~/.rh-jira-mcp.env file like this.
make setup
  1. Prepare a Jira token

To confirm it's working, run Cursor, go to Settings and click on "Tools & Integrations". Under MCP Tools you should see "jiraMcp" with 20 tools enabled.

Available Tools

This MCP server provides the following tools:

Issue Search

  • get_jira - Get details for a specific Jira issue by key.
  • search_issues - Search issues using JQL

Project Management

  • list_projects - List all projects
  • get_project - Get project details by key
  • get_project_components - Get components for a project
  • get_project_versions - Get versions for a project
  • get_project_roles - Get roles for a project
  • get_project_permission_scheme - Get permission scheme for a project
  • get_project_issue_types - Get issue types for a project

Board & Sprint Management

  • list_boards - List all boards
  • get_board - Get board details by ID
  • list_sprints - List sprints for a board
  • get_sprint - Get sprint details by ID
  • get_issues_for_board - Get issues for a board
  • get_issues_for_sprint - Get issues for a sprint

User Management

  • search_users - Search users by query
  • get_user - Get user details by account ID
  • get_current_user - Get current user info
  • get_assignable_users_for_project - Get assignable users for a project
  • get_assignable_users_for_issue - Get assignable users for an issue

Development Commands

  • make build - Build the image
  • make run - Run the container
  • make clean - Clean up the built image
  • make cursor-config - Modify ~/.cursor/mcp.json to install this MCP Server
  • make setup - Builds the image, configures Cursor, and creates ~/.rh-jira-mcp.env if it doesn't exist

Troubleshooting

Server Not Starting

  • Confirm that make run works
  • Check that the JIRA_API_TOKEN is correct
  • Verify the image was built successfully with podman images jira-mcp
  • Go to the "Output" tab in Cursor's bottom pane, choose "MCP Logs" from the drop-down select and examine the logs there

Connection Issues

  • Restart Cursor after configuration changes
  • Check Cursor's developer console for error messages
  • Verify the Jira URL is accessible from your network

License

This project is licensed under the MIT License. See the LICENSE file for details.

Related in Productivity - Secure MCP Servers

ServerSummaryActions
SmartsheetA Model Context Protocol (MCP) server that provides seamless integration with Smartsheet, enabling a...View
SpotifyA Model Context Protocol (MCP) server that connects Claude to Spotify, allowing you to control your...View
PlaneThe Plane MCP Server is a Model Context Protocol (MCP) server that provides seamless integration wit...View
iMCPiMCP is a macOS app for connecting your digital life with AI. It works with Claude Desktop and a gro...View
Date-time ToolsA Model Context Protocol (MCP) server for date-time manipulation and timezone conversion.View
AmazonThis server allows you to interact with Amazon's services using the MCP (Model Context Protocol) fra...View