Jira MCP Server

Jira MCP Server

A Model Context Protocol (MCP) server that brings Jira ticket context directly into Claude Code. Fetch complete ticket information including descriptions, comments, attachments, and linked Figma designs without leaving your development environment.

Overview

When working on development tasks, context switching between Jira and your code editor breaks flow and wastes time. This MCP server solves that by:

• Fetching complete ticket context - Get descriptions, comments, status, and metadata instantly
• Downloading attachments - Image attachments are downloaded and displayed inline
• Auto-fetching Figma designs - Linked Figma URLs are automatically detected and exported as images
• Enabling natural queries - Search tickets with JQL directly from Claude Code

Features

Installation

Prerequisites

• Node.js 18+
• Claude Code CLI
• Jira Cloud account with API access

Step 1: Add to Claude Code

claude mcp add --transport stdio jira -- npx -y @rui.branco/jira-mcp

Step 2: Get Your Jira API Token

1. Go to Atlassian API Tokens
2. Click "Create API token"
3. Enter a label (e.g., "Claude Code MCP")
4. Click "Create"
5. Copy the token (you won't be able to see it again)

Step 3: Configure Credentials

Run the setup with your credentials:

npx @rui.branco/jira-mcp setup "your@email.com" "YOUR_API_TOKEN" "https://company.atlassian.net"

Or run interactively (will prompt for each value):

npx @rui.branco/jira-mcp setup

Step 4: Verify

Restart Claude Code and run /mcp to verify the server is connected.

Alternative: Manual Installation

If you prefer to install manually:

git clone https://github.com/rui-branco/jira-mcp.git ~/.config/jira-mcp
cd ~/.config/jira-mcp && npm install
node setup.js

Then add to Claude Code:

claude mcp add --transport stdio jira -- node $HOME/.config/jira-mcp/index.js

Usage

Fetch a Ticket

> Get ticket PROJ-123

# Returns full ticket with description, comments, attachments, and Figma designs

Search Tickets

> Search for my open tickets

# Uses JQL: assignee = currentUser() AND status != Done

Add Comments with Mentions

Use @FirstName LastName syntax to mention users in comments:

> Add a comment to PROJ-123: "@John Doe Please review this implementation"

# The mention is automatically resolved and the user gets notified

Example Output

# PROJ-123: Implement user authentication

Status: In Progress | Type: Story | Priority: High
Assignee: John Doe | Reporter: Jane Smith

## Description
Implement OAuth2 authentication flow...

## Comments (2)
### Jane Smith - Jan 15, 2025
Please ensure we support Google SSO...

## Attachments (1)
- mockup.png (image/png, 245KB)
  [Image displayed inline]

## Figma Designs (1)
### Auth Flow Design - Login Screen
- Exported 3 image(s):
  - Login Form: ~/.config/figma-mcp/exports/...
  - Error States: ~/.config/figma-mcp/exports/...
  - Success State: ~/.config/figma-mcp/exports/...

Figma Integration

This MCP automatically detects Figma URLs in ticket descriptions and comments. When figma-mcp is configured:

• Figma links are automatically fetched
• Large frames are split into sections for better readability
• Images are exported at 2x scale for clarity
• All images are displayed inline in Claude Code

To enable Figma integration:

1. Install and configure figma-mcp
2. Restart Claude Code
3. Figma links will be auto-fetched when you get a ticket

API Reference

Tools