Jira MCP Server Details | Keeping you up to date on AI and Model Context Protocol (MCP)

✨ Features

📋 Access JIRA Directly From Cursor
- View your assigned issues without leaving your IDE
- Get detailed information on specific issues with one command
- Convert JIRA issues into local tasks seamlessly

🚀 Quick Start

Installation

# Clone the repository
git clone https://github.com/Dsazz/mcp-jira.git
cd mcp-jira

# Install dependencies
bun install

# Set up environment variables
cp .env.example .env
# Edit .env with your JIRA credentials

Configuration

Create a .env file with the following variables:

JIRA_HOST=https://your-instance.atlassian.net
JIRA_USERNAME=your-email@example.com
JIRA_API_TOKEN=your-jira-api-token-here

🔑 Important Note About JIRA API Tokens

Tokens may contain special characters, including the = sign

Place the token on a single line in the .env file

Do not add quotes around the token value

Paste the token exactly as provided by Atlassian

🛠️ Development Tools

Code Quality Tools

The project uses Biome for code formatting and linting, replacing the previous ESLint setup. Biome provides:

Fast, unified formatting and linting
TypeScript-first tooling
Zero configuration needed
Consistent code style enforcement

To format and lint your code:

# Format code
bun format

# Check code for issues
bun check

# Type check
bun typecheck

MCP Inspector

Integration with Claude Desktop

🔌 Integration with Cursor IDE

⚠️ Important: You must build the project with bun run build before integrating with Cursor IDE or Claude Desktop.

Add this MCP server to your Cursor IDE's MCP configuration:

{
  "mcpServers": {
    "JIRA Tools": {
      "command": "node", // or "bun"
      "args": ["/absolute/path/to/your/project/dist/index.js"],
      "env": {
        "JIRA_USERNAME": "your-jira-username",
        "JIRA_API_TOKEN": "your-jira-api-token",
        "JIRA_HOST": "your-jira-host.atlassian.net"
      }
    }
  }
}

🧰 Available Tools

JIRA Tools

Tool	Description	Parameters	Returns
`jira_get_assigned_issues`	Retrieves all issues assigned to you	None	Markdown-formatted list of issues
`jira_get_issue`	Gets detailed information about a specific issue	`issueKey`: Issue key (e.g., PD-312)	Markdown-formatted issue details
`jira_create_task`	Creates a local task from a JIRA issue	`issueKey`: Issue key (e.g., PD-312)	Markdown-formatted task

📁 Project Structure

 src/
  ├── core/          # Core functionality and configurations
  ├── features/      # Feature implementations
  │   └── jira/      # JIRA API integration
  │       ├── api/         # JIRA API client
  │       ├── formatters/  # Response formatters
  │       └── tools/       # MCP tool implementations
  └── test/          # Test utilities

NPM Scripts

Command	Description
`bun dev`	Run the server in development mode with hot reload
`bun build`	Build the project for production
`bun start`	Start the production server
`bun format`	Format code using Biome
`bun lint`	Lint code using Biome
`bun check`	Run Biome checks on code
`bun typecheck`	Run TypeScript type checking
`bun test`	Run tests
`bun inspect`	Start the MCP Inspector for debugging
`bun cleanup-ports`	Clean up ports used by the development server

📝 Contributing

We welcome contributions! Please see our Contributing Guide for details on:

Development workflow
Branching strategy
Commit message format
Pull request process
Code style guidelines

Jira