Jira-Context-MCP

Integrations

  • Uses .ENV for configuration management, allowing users to set up Jira connection details including base URL, username, and API token.

  • Enables GitHub integration for code analysis and workflow management as evidenced by the CodeQL badge and GitHub Actions workflow reference.

  • Integrates with Jira's API to fetch issue details, retrieve assigned tickets, filter issues by type, list projects, get issue types, and track recent changes in tickets, enabling AI-powered Jira ticket management directly within Cursor IDE.

Jira Context MCP

A Model Context Protocol (MCP) implementation for Jira that allows you to:

  • Input a Jira ticket link to fetch issue details and instruct Cursor to fix it
  • Retrieve all tickets assigned to you within a specified Jira project
  • Filter Jira issues based on a specific issue type and automatically direct Cursor to resolve them
  • Integrate seamlessly with Jira's API for automation and efficiency

Setup

Prerequisites

  • Node.js 20.17.0 or higher
  • A Jira account with API access
  • A Jira API token (can be generated at Atlassian API Tokens)

Installation

Installing via Smithery

To install Jira Context MCP for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @rahulthedevil/Jira-Context-MCP --client claude
Installing manually
  1. Clone this repository:
    git clone https://github.com/yourusername/Jira-Context-MCP.git cd Jira-Context-MCP
  2. Install dependencies:
    npm install # or if you use pnpm pnpm install
  3. Create a .env file based on the example:
    cp .env.example .env
  4. Edit the .env file with your Jira details:
    JIRA_BASE_URL=https://your-domain.atlassian.net JIRA_USERNAME=your-email@example.com JIRA_API_TOKEN=your-api-token-here HTTP_PORT=3000

Build

Build the project with:

npm run build # or pnpm build

Usage

Starting the Server

Start the HTTP server:

npm start # or pnpm start

Or use the CLI mode:

npm run start:cli # or pnpm start:cli

Connecting with Cursor

  1. In Cursor, open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P)
  2. Type "Connect to MCP Server"
  3. Select "Connect to MCP Server"
  4. Enter the server URL (default: http://localhost:3000/sse)

Available Tools

Once connected, you can use the following tools in Cursor:

1. Get Jira Issue Details

Fetch detailed information about a specific Jira issue:

/get_issue issueKey:PROJECT-123

2. Get Assigned Issues

Retrieve issues assigned to you in a specific project:

/get_assigned_issues projectKey:PROJECT maxResults:10

3. Get Issues by Type

Filter issues by type (Bug, Story, Epic, etc.):

/get_issues_by_type issueType:Bug projectKey:PROJECT maxResults:10

4. Get Projects

List all available projects:

/get_projects

5. Get Issue Types

List all available issue types:

/get_issue_types

6. Get Recent Ticket Changes

Retrieve changes made in tickets over a specified period (e.g., the last 7 days) in a project:

/get_recent_changes projectKey:PROJECT maxDays:7

Command Examples

🚀 Jira MCP Server + Cursor IDE = Your AI-powered Jira assistant! Here’s how it makes devs work smarter:

📂 "List all Jira projects I have access to"
→ AI fetches all available projects instantly
No more searching manually!

📋 "List all issues in PROJECT"
→ AI retrieves all open tickets
Stay organized without effort!

🐛 "Filter only Bugs or Change Requests and fix them"
→ AI identifies & directs Cursor to resolve them
Fix issues faster with automation!

"Find all tickets assigned to me and fix them"
→ AI pulls your tasks & lets Cursor handle them
Stay on top of your work with zero hassle!

🔍 "Get details for Jira issue PROJECT-123"
→ AI fetches full issue info in seconds
No more switching tabs!

📊 "What changed in tickets in the last 7 days in PROJECT?"
→ AI tracks recent updates & highlights key changes
No more manually checking ticket histories!

🔥 TL;DR: Your AI now speaks Jira + Cursor! Fetch projects, filter issues, track changes & fix bugs—all inside your IDE.
From backlog to bug fixes, MCP Server makes Jira work for you!

Example Workflows

Fix a Specific Bug

  1. Connect to the Jira MCP server in Cursor.
  2. Get the issue details:
    /get_issue issueKey:PROJECT-123
  3. Review the issue details and instruct Cursor to fix it:
    Fix the bug described in PROJECT-123

Work on Your Assigned Issues

  1. Connect to the Jira MCP server in Cursor.
  2. Retrieve your assigned issues:
    /get_assigned_issues projectKey:PROJECT
  3. Ask Cursor to help with one of the issues:
    Help me solve the first issue in my assigned list

Fix All Bugs in a Project

  1. Connect to the Jira MCP server in Cursor.
  2. Retrieve all bug issues:
    /get_issues_by_type issueType:Bug projectKey:PROJECT
  3. Instruct Cursor:
    Help me fix these bugs one by one

Review Recent Changes

  1. Connect to the Jira MCP server in Cursor.
  2. Retrieve recent ticket updates:
    /get_recent_changes projectKey:PROJECT maxDays:7
  3. Review the changes to stay updated on modifications.

Development

Project Structure

  • src/ - Source code
    • services/ - Jira API service
    • types/ - TypeScript type definitions
    • utils/ - Utility functions
    • server.ts - MCP server implementation
    • index.ts - Application entry point
    • cli.ts - CLI entry point

Adding New Tools

To add new tools, edit the src/server.ts file and add new tool definitions in the registerTools method.

License

MIT

Author

Rahul Dey - @rahulthedevil

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

MCP server to provide Jira Tickets information to AI coding agents like Cursor

  1. Setup
    1. Prerequisites
    2. Installation
    3. Build
  2. Usage
    1. Starting the Server
    2. Connecting with Cursor
  3. Available Tools
    1. 1. Get Jira Issue Details
    2. 2. Get Assigned Issues
    3. 3. Get Issues by Type
    4. 4. Get Projects
    5. 5. Get Issue Types
    6. 6. Get Recent Ticket Changes
  4. Command Examples
    1. Example Workflows
      1. Fix a Specific Bug
      2. Work on Your Assigned Issues
      3. Fix All Bugs in a Project
      4. Review Recent Changes
    2. Development
      1. Project Structure
      2. Adding New Tools
    3. License
      1. Author

        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
          Python
          MIT License
          • Apple
        • A
          security
          A
          license
          A
          quality
          A TypeScript-based server that enables Cursor editor to interact with Jira tickets for viewing, creating, commenting on, and updating tickets directly from the editor.
          Last updated -
          7
          TypeScript
          GPL 2.0
        • -
          security
          F
          license
          -
          quality
          A server that allows AI assistants to access and retrieve Linear ticket data through the Model Context Protocol (MCP) standard, currently focused on fetching a user's todo tickets.
          Last updated -
          324
          TypeScript
        • -
          security
          A
          license
          -
          quality
          MCP server to provide Sketch layout information to AI coding agents like Cursor
          Last updated -
          63
          32
          JavaScript
          MIT License

        View all related MCP servers

        ID: a8ob8depqc