Skip to main content
Glama

Jira MCP Server

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 assooperset/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.

Quick Start

  1. Prepare a Jira token

  2. Configure Cursor

    • In Cursor go to "Settings", "Tools & Integrations", and click "New MCP Server"

    • Paste in the following JSON, (or insert just the jiraMcp object under the mcpServers key).

    • Update "/path/to/your/dotenv/file.env" to point to the file from step 1.

    • Save

{ "mcpServers": { "jiraMcp": { "command": "podman", "args": [ "run", "-i", "--rm", "--env-file", "/path/to/your/dotenv/file.env", "quay.io/sbaird/jira-mcp:latest" ], "description": "A containerized MCP server to query Jira issues" } } }

Quick Start (for developers)

  1. Prerequisites

    • podman - Install with sudo dnf install podman (Fedora/RHEL) or brew install podman (macOS)

    • yq - Install with sudo dnf install yq (Fedora/RHEL) or brew install yq (macOS)

    • make - Usually pre-installed on most systems

  2. 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

  2. Decide whether to enable write operations

Enabling your MCP server to make edits to Jira can be very useful, but can also cause a lot of problems if you are not careful in how you use the MCP tools. By default, the server has write operations turned off. If you want to turn it on, edit the .rh-jira-mcp.env file in your home directory to set JIRA_ENABLE_WRITE=true.

  1. Check if it is working in Cursor

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 if JIRA_ENABLE_WRITE=false (the default value) or 30 tools enabled if JIRA_ENABLE_WRITE=true.

Using with an HTTP-based MCP application

If you want to use this MCP server with an application that communicates via HTTP, then you need to run the server with an HTTP-based transport mechanism. Here is an example of how to do this using Streamable HTTP, which is the current recommended http-based transport mechanism for MCP:

export $(grep -v '^#' ~/.rh-jira-mcp.env | xargs) && python server.py --transport http --port 3075

Here is an example of how to do this using SSE, which is a deprecated http-based transport mechanism (e.g., because you have an older MCP client application that depends on SSE):

export $(grep -v '^#' ~/.rh-jira-mcp.env | xargs) && python server.py --transport sse --port 3075

Available Tools

This MCP server provides the following tools:

Issue Search & Retrieval

  • get_jira - Get details for a specific Jira issue by key.

  • search_issues - Search issues using JQL

Issue Creation & Management

  • create_issue - Create a new Jira issue with summary, description, type, priority, and assignee

  • update_issue - Update an existing issue's summary, description, priority, or assignee

  • delete_issue - Delete a Jira issue (use with caution)

Issue Comments

  • get_issue_comments - Get all comments for a Jira issue

  • add_comment - Add a comment to a Jira issue

  • delete_comment - Delete a comment from a Jira issue

Issue Assignment

  • assign_issue - Assign a Jira issue to a user

  • unassign_issue - Unassign a Jira issue

Issue Workflow & Status

  • transition_issue - Transition a Jira issue to a new status (e.g., "In Progress", "Done")

  • get_issue_transitions - Get available transitions for a Jira issue

Issue Labels

  • add_issue_labels - Add labels to a Jira issue

  • remove_issue_labels - Remove labels from a Jira issue

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

  • list_sprints - List sprints for a board

  • get_sprint - Get sprint details by ID

  • get_sprints_by_name - Get sprints by name for a board, optionally filtered by state

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

  • (MacOS) jiraMcp shows up in Cursor tools section but shows no active tools:

    • Edit args section of jiraMcp of your mcp.json file to include your full path to the .rh-jira-mcp.env file.

    • Example: "~/.rh-jira-mcp.env", to "/Users/your_username/.rh-jira-mcp.env",

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.

-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A simple MCP server that provides access to Jira issues from Cursor AI, allowing users to reference and query Jira tickets directly in the chat panel.

  1. Quick Start
    1. Quick Start (for developers)
      1. Using with an HTTP-based MCP application
        1. Available Tools
          1. Issue Search & Retrieval
          2. Issue Creation & Management
          3. Issue Comments
          4. Issue Assignment
          5. Issue Workflow & Status
          6. Issue Labels
          7. Project Management
          8. Board & Sprint Management
          9. User Management
        2. Development Commands
          1. Troubleshooting
            1. Server Not Starting
            2. Connection Issues
          2. License

            Related MCP Servers

            • -
              security
              A
              license
              -
              quality
              Enables AI applications to manage JIRA issues, workflows, and tasks through a standardized MCP interface, facilitating real-time updates and seamless interaction with JIRA's API.
              Last updated -
              6
              MIT License
              • Apple
            • -
              security
              A
              license
              -
              quality
              MCP server to provide Jira Tickets information to AI coding agents like Cursor
              Last updated -
              119
              22
              MIT License
            • A
              security
              A
              license
              A
              quality
              A Model Context Protocol server that integrates JIRA directly into Cursor IDE, allowing users to view assigned issues, get detailed information on specific tickets, and convert JIRA issues into local tasks without leaving their editor.
              Last updated -
              14
              12
              6
              TypeScript
              MIT License
              • Apple
            • A
              security
              A
              license
              A
              quality
              An MCP server that enables communication with Jira, allowing users to perform operations like getting, searching, creating, and editing issues through natural language interaction.
              Last updated -
              1
              28
              MIT License

            View all related MCP servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/redhat-community-ai-tools/jira-mcp'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server