Jira Context Mcp

# Jira Context MCP [](https://github.com/rahulthedevil/Jira-Context-MCP/actions/workflows/codeql.yml) [](https://smithery.ai/server/@rahulthedevil/Jira-Context-MCP) <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](https://id.atlassian.com/manage-profile/security/api-tokens))

Installation

Installing via Smithery

To install Jira Context MCP for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@rahulthedevil/Jira-Context-MCP):

```bash npx -y @smithery/cli install @rahulthedevil/Jira-Context-MCP --client claude ```

Installing manually

1. Clone this repository: ```bash git clone https://github.com/yourusername/Jira-Context-MCP.git cd Jira-Context-MCP ```

2. Install dependencies: ```bash npm install

   or if you use pnpm

   pnpm install ```

3. Create a `.env` file based on the example: ```bash 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:

```bash npm run build

or

pnpm build ```

Usage

Starting the Server

Start the HTTP server:

```bash npm start

or

pnpm start ```

Or use the CLI mode:

```bash 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](https://github.com/rahulthedevil)