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
Step 1: Add to Claude Code
Step 2: Get Your Jira API Token
Go to Atlassian API Tokens
Click "Create API token"
Enter a label (e.g., "Claude Code MCP")
Click "Create"
Copy the token (you won't be able to see it again)
Step 3: Configure Credentials
Run the setup with your credentials:
Parameter | Description | Example |
Your Atlassian account email |
| |
API Token | The token you created in Step 2 |
|
Base URL | Your Jira instance URL |
|
Or run interactively (will prompt for each value):
Step 4: Verify
Restart Claude Code and run /mcp to verify the server is connected.
Alternative: Manual Installation
If you prefer to install manually:
Then add to Claude Code:
Usage
Fetch a Ticket
Search Tickets
Add Comments with Mentions
Use @FirstName LastName syntax to mention users in comments:
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 |
| Get the current authenticated user's accountId and info (use for assigning tickets) | none |
| Fetch a ticket by key with description, comments, attachments, and Figma designs |
|
| Search tickets using JQL |
|
| Add a comment to a ticket (supports @mentions) |
|
| Reply to a specific comment with quote and mention |
|
| Edit an existing comment (supports @mentions) |
|
| Delete a comment (irreversible) |
|
| Change ticket status by name or ID (auto-handles intermediate steps) |
|
| Update ticket fields (summary, description, assignee, priority, labels) |
|
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