Connects to Atlassian Jira Cloud accounts to retrieve and manage ticket context and metadata via API access.
Automatically detects, fetches, and exports Figma design URLs linked within Jira tickets into high-quality images for visual context.
Fetches comprehensive ticket information including summaries, descriptions, comments, attachments, and statuses, and supports searching across the instance using JQL.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Jira MCP Servershow me the details and comments for PROJ-123"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Quick Setup
The setup will prompt for:
Jira email - Your Atlassian account email
API token - Generate at Atlassian API Tokens
Base URL - Your Jira instance (e.g.,
https://company.atlassian.net)
Alternative: Command-Line Setup
Claude Code Configuration
Add to your ~/.claude.json:
Note: If you cloned to a different location, update the path accordingly.
Restart Claude Code to load the MCP server.
Usage
Fetch a Ticket
Search Tickets
Example Output
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:
Install and configure figma-mcp
Restart Claude Code
Figma links will be auto-fetched when you get a ticket
API Reference
Tools
Tool | Description | Parameters |
| Fetch a ticket by key |
|
| Search with JQL |
|
Configuration
Config stored at ~/.config/jira-mcp/config.json:
Error Handling
The server provides clear error messages:
Error | Meaning |
| Too many Figma requests, wait a few minutes |
| Check Figma token or file permissions |
| Install and configure figma-mcp |
Security
API tokens are stored locally in
~/.config/jira-mcp/config.jsonConfig files are excluded from git via
.gitignoreTokens are never logged or transmitted except to Jira/Figma APIs
Attachments are downloaded to
~/.config/jira-mcp/attachments/
License
MIT
Related
figma-mcp - Figma MCP server for Claude Code
Model Context Protocol - MCP specification