Jira MCP Server For Cursor

A TypeScript-based Jira MCP server that supports integration with Cursor, providing functions for viewing, creating, commenting on, and updating the status of Jira tickets.

Developer tools Customer support #Jira Integration #Ticket Management #Cursor Plugin #Development Tools .TypeScript

rating : 2 points

downloads : 15

update time : 2025-04-28

What is Jira MCP Server?

This server acts as a bridge between your Cursor IDE and Jira project management system. It allows developers to view, create, and manage Jira tickets without leaving their coding environment.

How to use Jira MCP Server?

After setup, you can access Jira functionality through simple commands in Cursor. The server handles all communication with Jira's API while providing a clean interface in your IDE.

Ideal Use Cases

Perfect for developers who need to frequently reference or update Jira tickets while coding. Especially valuable for agile teams practicing continuous integration.

Key Features

Ticket ViewingView complete Jira ticket details including description, status and assignee directly in Cursor.

Ticket ManagementCreate new tickets and update existing ones without switching applications.

Comment SystemRead and add comments to tickets while working on related code.

Status UpdatesTransition tickets through workflows (e.g., from 'In Progress' to 'Done').

Pros and Cons

Advantages

Saves time by eliminating context switching between IDE and browser

Keeps development workflow focused and efficient

Reduces errors by providing ticket details in coding context

Supports agile development practices

Limitations

Requires Jira API access permissions

Limited to basic ticket operations (no complex Jira features)

Needs initial setup configuration

Getting Started

Install Dependencies

Ensure you have Node.js installed, then install project dependencies.

Configure Environment

Create a .env file with your Jira credentials and server settings.

Start the Server

Run the server in development mode for testing.

Configure Cursor

Add the MCP server configuration to Cursor's settings.

Usage Scenarios

Checking Related TicketsWhile working on a feature, quickly check all open tickets in the current project.

Updating Ticket StatusMark a ticket as completed after finishing the related code changes.

Adding Contextual CommentAdd implementation notes to a ticket while working on the solution.

Frequently Asked Questions

How do I get a Jira API token?

Can I search across multiple projects?

What Jira features aren't supported?

Additional Resources

Official Jira API Documentation

Complete reference for Jira's REST API

Cursor Documentation

Official docs for Cursor IDE features

Project Repository

Source code and issue tracking

🚀 A Comprehensive Guide to Managing Jira Tickets Using REST API

This guide provides a detailed overview of using REST API to manage Jira tickets and projects. It includes various endpoints for ticket and project operations, such as creating, updating, deleting, and retrieving information.

🚀 Quick Start

This guide will introduce you to a series of REST APIs for managing Jira tickets and projects. Each API includes a function description, request method, request path, request parameters, and response examples.

✨ Features

Ticket Management: Retrieve, create, update, and delete tickets.
Project Management: Retrieve, create, update, and delete projects.
Comment Management: Retrieve, create, update, and delete comments on tickets.

💻 Usage Examples

1. Get Ticket List

Function Description

This API is used to get all tickets under a specified project.

Request Method

GET

Request Path

/tickets?projectId={ projectId }

Request Parameters

Property	Details
projectId	String, Required. The ID of the project.

Response Example

[
  {
    "id": "TICKET-001",
    "title": "Problem description",
    "status": "Unsolved",
    "assignee": "Zhang San",
    "description": "Detailed problem description..."
  },
  ...
]

2. Create a New Ticket

Function Description

This API is used to create a new ticket.

Request Method

POST

Request Path

/tickets

Request Body Parameters

Property	Details
title	String, Required. The title of the ticket.
description	String, Required. The description of the ticket.
projectId	String, Required. The ID of the project.
issueType	String, Required. The type of the ticket (e.g., Problem, Task).

Response Example

{
  "message": "Ticket created successfully",
  "ticketId": "TICKET-001"
}

3. Update an Existing Ticket

Function Description

This API is used to update a ticket with the specified ID.

Request Method

PUT

Request Path

/tickets/{ ticketId }

Request Parameters

Property	Details
ticketId	String, Required. The ID of the ticket.

Request Body Parameters

Property	Details
title	String, Optional. The title of the ticket.
description	String, Optional. The description of the ticket.
assignee	String, Optional. The assignee of the ticket.
status	String, Optional. The status of the ticket (e.g., Unsolved, Solved).

Response Example

{
  "message": "Ticket updated successfully"
}

4. Delete a Specified Ticket

Function Description

This API is used to delete a ticket with the specified ID.

Request Method

DELETE

Request Path

/tickets/{ ticketId }

Request Parameters

Property	Details
ticketId	String, Required. The ID of the ticket.

Response Example

{
  "message": "Ticket deleted successfully"
}

5. Get Details of a Single Ticket

Function Description

This API is used to get detailed information about a ticket with the specified ID.

Request Method

GET

Request Path

/tickets/{ ticketId }

Request Parameters

Property	Details
ticketId	String, Required. The ID of the ticket.

Response Example

{
  "id": "TICKET-001",
  "title": "Problem description",
  "description": "Detailed problem description...",
  "assignee": "Zhang San",
  "status": "Unsolved"
}

6. Get List of All Projects

Function Description

This API is used to get all available projects.

Request Method

GET

Request Path

/projects

Response Example

[
  {
    "id": "PROJECT-001",
    "name": "Project name",
    "description": "Project description..."
  },
  ...
]

7. Create a New Project

Function Description

This API is used to create a new project.

Request Method

POST

Request Path

/projects

Request Body Parameters

Property	Details
name	String, Required. The name of the project.
description	String, Optional. The description of the project.

Response Example

{
  "message": "Project created successfully",
  "projectId": "PROJECT-001"
}

8. Update an Existing Project

Function Description

This API is used to update a project with the specified ID.

Request Method

PUT

Request Path

/projects/{ projectId }

Request Parameters

Property	Details
projectId	String, Required. The ID of the project.

Request Body Parameters

Property	Details
name	String, Optional. The name of the project.
description	String, Optional. The description of the project.

Response Example

{
  "message": "Project updated successfully"
}

9. Delete a Specified Project

Function Description

This API is used to delete a project with the specified ID.

Request Method

DELETE

Request Path

/projects/{ projectId }

Request Parameters

Property	Details
projectId	String, Required. The ID of the project.

Response Example

{
  "message": "Project deleted successfully"
}

10. Get All Tickets Under a Project

Function Description

This API is used to get all tickets under a specified project.

Request Method

GET

Request Path

/projects/{ projectId }/tickets

Request Parameters

Property	Details
projectId	String, Required. The ID of the project.

Response Example

[
  {
    "id": "TICKET-001",
    "title": "Problem description",
    "status": "Unsolved",
    "assignee": "Zhang San",
    "description": "Detailed problem description..."
  },
  ...
]

11. Get Comment List of a Ticket

Function Description

This API is used to get all comments on a specified ticket.

Request Method

GET

Request Path

/tickets/{ ticketId }/comments

Request Parameters

Property	Details
ticketId	String, Required. The ID of the ticket.

Response Example

[
  {
    "id": "COMMENT-001",
    "content": "This is a comment...",
    "author": "Zhang San",
    "createdAt": "2023-01-01T12:00:00Z"
  },
  ...
]

12. Create a New Ticket Comment

Function Description

This API is used to create a new comment on a specified ticket.

Request Method

POST

Request Path

/tickets/{ ticketId }/comments

Request Parameters

Property	Details
ticketId	String, Required. The ID of the ticket.

Request Body Parameters

Property	Details
content	String, Required. The content of the comment.

Response Example

{
  "message": "Comment created successfully",
  "commentId": "COMMENT-001"
}

13. Update a Ticket Comment

Function Description

This API is used to update a comment with the specified ID.

Request Method

PUT

Request Path

/tickets/{ ticketId }/comments/{ commentId }

Request Parameters

Property	Details
ticketId	String, Required. The ID of the ticket.
commentId	String, Required. The ID of the comment.

Request Body Parameters

Property	Details
content	String, Required. The content of the comment.

Response Example

{
  "message": "Comment updated successfully"
}

14. Delete a Ticket Comment

Function Description

This API is used to delete a comment with the specified ID.

Request Method

DELETE

Request Path

/tickets/{ ticketId }/comments/{ commentId }

Request Parameters

Property	Details
ticketId	String, Required. The ID of the ticket.
commentId	String, Required. The ID of the comment.

Response Example

{
  "message": "Comment deleted successfully"
}

📚 Documentation

The above is the complete specification for RESTful API design, covering project creation, update, deletion, and related operations on tickets and comments. Through these APIs, you can achieve comprehensive management of projects, tickets, and comments to meet common requirements.