MCP JIRA Server

What is MCP JIRA Server?

MCP JIRA Server is a Model Context Protocol (MCP) server that provides JIRA integration for AI tools. It enables AI assistants to create and manage JIRA issues with rich markdown formatting, automatic conversion to Atlassian Document Format (ADF), and flexible field management through the JIRA REST API v3.

How to use MCP JIRA Server?

Install the server from source using UV, create a config.yaml with your JIRA instance details and API token, then run mcp_jira-server (stdio transport) or mcp_jira-server --transport sse --port 3001 (SSE transport). The server exposes two tools: create_jira_issue and update_jira_issue.

Key features of MCP JIRA Server

• Rich markdown support with automatic conversion to Atlassian Document Format
• Multi-site JIRA configuration with flexible site selection
• Robust assignee handling resolving email to JIRA accountId
• Support for standard and custom JIRA fields via additional_fields parameter
• stdio and SSE transport modes for deployment flexibility
• Comprehensive error handling and rotating file logging

Use cases of MCP JIRA Server

• AI assistants creating well-formatted JIRA issues from natural language conversations
• Automated issue creation and updates across multiple JIRA instances
• Bulk issue management with markdown descriptions for documentation workflows

FAQ from MCP JIRA Server

How do I configure MCP JIRA Server for my JIRA instance?

Create a config.yaml file with your JIRA site URL, email, and API token. The server loads this file from a command-line argument, environment variable, or default OS-specific path, and will generate a template if none is found.

What are the system requirements for MCP JIRA Server?

Python 3.11 or later (but not 3.13), Linux/macOS/Windows operating system, network access to JIRA instance(s), and a valid JIRA API token.

How does MCP JIRA Server handle authentication?

The server authenticates using a JIRA API token combined with your account email. You create the token in your JIRA Account Settings under Security > API token, then add it to your config.yaml file.

What transports does MCP JIRA Server support?

The server supports both stdio transport (default) and SSE transport (use --transport sse --port 3001). The configuration editor is built with Streamlit and runs via streamlit run mcp_jira/ui/app.py.

Where does MCP JIRA Server store logs?

The server logs to stderr and rotating log files in OS-specific locations (e.g., ~/Library/Logs/mcp_jira/mcp_jira.log on macOS, ~/.local/state/mcp_jira/mcp_jira.log on Linux). Logging behavior is configured in config.yaml or overridden via the MCP_JIRA_LOG_LEVEL environment variable.