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