jira_mcp_server

amarmohite2001/jira_mcp_server

3.1

If you are the rightful owner of jira_mcp_server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

MCP Server for Jira is a specialized server designed to integrate Jira with Model Context Protocol (MCP) technology, enhancing project management capabilities.

Jira MCP Server

A secure Model Context Protocol (MCP) server for Jira integration that provides seamless access to Jira issues, comments, and editing capabilities.

Features

  • 🔒 Secure Authentication: Environment-based API key and base64 encoding
  • 📋 Issue Details: Fetch comprehensive issue information including description, status, and comments
  • 💬 Comment Management: Add comments to keep issues up to date
  • ✏️ Description Editing: Update and format issue descriptions
  • 🔌 stdio Protocol: Uses secure stdio transport for MCP communication

Setup

1. Install Dependencies

uv sync

2. build the project

uv cache clean
uv build

Copy the example environment file and configure your Jira credentials:

uv cache clean
uv build

3. Generate Jira API Token

  1. Go to your Jira profile settings
  2. Navigate to Security → API tokens
  3. Create a new token and copy it to your .env file

Usage

Running the Server on VS Code

open-> .vscode/mcp.json paste the following configuration:

{
  "servers": {
    "Jira-MCP-Server": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", ".", "jira-mcp-server"],
      "env": {
        "JIRA_API_KEY": "your_jira_api_key",
        "JIRA_EMAIL": "your_jira_email",
        "JIRA_BASE_URL": "https://your_jira_instance.atlassian.net"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

NOTE: if . doesnt point to the root of your project, you need to change the args value to point to the correct path.

Available Tools

1. Get Issue Details

get_jira_issue(issue_key="PROJ-123")

Returns formatted issue information including:

  • Summary, status, assignee, reporter, priority
  • Full description
  • Last 5 comments with authors and dates
2. Add Comment
add_jira_comment(issue_key="PROJ-123", comment="Your comment text here")

Adds a new comment to the specified issue.

3. Update Description
update_jira_description(issue_key="PROJ-123", description="Updated description text")

Updates the issue description with new formatted content.

Security Features

  • ✅ Environment variable-based authentication
  • ✅ Base64 encoded API credentials
  • ✅ HTTPS-only communication with Jira API
  • ✅ No hardcoded secrets or credentials
  • ✅ Secure stdio transport protocol

Error Handling

The server includes comprehensive error handling for:

  • Missing environment variables
  • Invalid Jira issue keys
  • Network connectivity issues
  • Authentication failures
  • API rate limiting

Requirements

  • Python 3.13+
  • Valid Jira Cloud account with API access
  • Network access to your Jira instance