Enables integration with Atlassian products, specifically Jira, for retrieving issue information and interacting with the Jira platform.
Supports environment variable configuration through .env files for storing credentials and configuration settings like Jira tokens and URLs.
Provides access to Jira, allowing users to query and retrieve information about Jira issues through the Cursor interface.
redhat-ai-tools/jira-mcp
A containerized Python MCP server for Cursor to provide access to Jira.
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
Prepare a Jira token
Go to Red Hat Jira Personal Access Tokens and create a token
Create a .env file similar to example.env
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 themcpServers
key).Update
"/path/to/your/dotenv/file.env"
to point to the file from step 1.Save
Quick Start (for developers)
Prerequisites
podman - Install with
sudo dnf install podman
(Fedora/RHEL) orbrew install podman
(macOS)yq - Install with
sudo dnf install yq
(Fedora/RHEL) orbrew install yq
(macOS)make - Usually pre-installed on most systems
Get the code
Build the image & configure Cursor This also creates a
~/.rh-jira-mcp.env
file like this.
Prepare a Jira token
Go to Red Hat Jira Personal Access Tokens and create a token
Edit the
.rh-jira-mcp.env
file in your home directory and paste in the token
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
.
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:
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):
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 assigneeupdate_issue
- Update an existing issue's summary, description, priority, or assigneedelete_issue
- Delete a Jira issue (use with caution)
Issue Comments
get_issue_comments
- Get all comments for a Jira issueadd_comment
- Add a comment to a Jira issuedelete_comment
- Delete a comment from a Jira issue
Issue Assignment
assign_issue
- Assign a Jira issue to a userunassign_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 issueremove_issue_labels
- Remove labels from a Jira issue
Project Management
list_projects
- List all projectsget_project
- Get project details by keyget_project_components
- Get components for a projectget_project_versions
- Get versions for a projectget_project_roles
- Get roles for a projectget_project_permission_scheme
- Get permission scheme for a projectget_project_issue_types
- Get issue types for a project
Board & Sprint Management
list_boards
- List all boardslist_sprints
- List sprints for a boardget_sprint
- Get sprint details by IDget_sprints_by_name
- Get sprints by name for a board, optionally filtered by state
User Management
search_users
- Search users by queryget_user
- Get user details by account IDget_current_user
- Get current user infoget_assignable_users_for_project
- Get assignable users for a projectget_assignable_users_for_issue
- Get assignable users for an issue
Development Commands
make build
- Build the imagemake run
- Run the containermake clean
- Clean up the built imagemake cursor-config
- Modify~/.cursor/mcp.json
to install this MCP Servermake 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
worksCheck 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.
This server cannot be installed
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.
Related MCP Servers
- -securityAlicense-qualityEnables 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 -6MIT License
- -securityAlicense-qualityMCP server to provide Jira Tickets information to AI coding agents like CursorLast updated -11922MIT License
- AsecurityAlicenseAqualityA 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 -14126TypeScriptMIT License
- AsecurityAlicenseAqualityAn 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 -128MIT License