Skip to main content
Glama

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

Feature

Description

Full Ticket Details

Summary, description, status, priority, assignee, reporter, sprint, parent

Comments

All comments with author and timestamp

Attachments

Auto-download image attachments (PNG, JPG, GIF, WebP)

Linked Issues

View related tickets and their relationships

Figma Integration

Auto-detect and export Figma designs linked in tickets

JQL Search

Search across your Jira instance with powerful queries

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"

Parameter

Description

Example

Email

Your Atlassian account email

john@company.com

API Token

The token you created in Step 2

ATATT3xFfGF0...

Base URL

Your Jira instance URL

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

Tool

Description

Parameters

jira_get_myself

Get the current authenticated user's accountId and info (use for assigning tickets)

none

jira_get_ticket

Fetch a ticket by key with description, comments, attachments, and Figma designs

issueKey (required), downloadImages, fetchFigma

jira_search

Search tickets using JQL

jql (required), maxResults

jira_add_comment

Add a comment to a ticket (supports @mentions)

issueKey (required), comment (required)

jira_reply_comment

Reply to a specific comment with quote and mention

issueKey (required), commentId (required), reply (required)

jira_edit_comment

Edit an existing comment (supports @mentions)

issueKey (required), commentId (required), comment (required)

jira_delete_comment

Delete a comment (irreversible)

issueKey (required), commentId (required)

jira_transition

Change ticket status by name or ID (auto-handles intermediate steps)

issueKey (required), targetStatus or transitionId

jira_update_ticket

Update ticket fields (summary, description, assignee, priority, labels)

issueKey (required), plus optional field parameters

Configuration

Config stored at ~/.config/jira-mcp/config.json:

{ "email": "your@email.com", "token": "YOUR_API_TOKEN", "baseUrl": "https://company.atlassian.net" }

Error Handling

The server provides clear error messages:

Error

Meaning

Figma API rate limit exceeded

Too many Figma requests, wait a few minutes

Figma access denied

Check Figma token or file permissions

Figma not configured

Install and configure figma-mcp

Security

  • API tokens are stored locally in ~/.config/jira-mcp/config.json

  • Config files are excluded from git via .gitignore

  • Tokens are never logged or transmitted except to Jira/Figma APIs

  • Attachments are downloaded to ~/.config/jira-mcp/attachments/

License

MIT

-
security - not tested
F
license - not found
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/rui-branco/jira-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server