mcpserver.so LogoMCPFly
Submit
Jira Context MCP logo

Jira Context MCP

by rahulthedevil

Productivity/Task & Project ManagementJiraCursorAutomationIssue TrackingAPI

Jira Context MCP is a Model Context Protocol (MCP) implementation for Jira that allows you to fetch issue details and instruct Cursor to fix them, retrieve assigned tickets, and filter issues by type. It integrates seamlessly with Jira's API for automation and efficiency.

View on GitHub

Last updated: N/A

Jira Context MCP

CodeQL Advanced

CodeQL Advanced

smithery badge

smithery badge

<figure> <a href="https://glama.ai/mcp/servers/a8ob8depqc"> <img width="380" height="200" src="https://glama.ai/mcp/servers/a8ob8depqc/badge" /> </a> </figure>

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
[email protected]
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