MCP JIRA Server
About
MCP (Model Context Protocol) server for JIRA integration
Details
- Author
- codingthefuturewithai
- Downloads
- 436
- Categories
- Developer Tools
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCP JIRA ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp jira server": {
"mcp_jira": {
"command": "uv",
"args": [
"venv"
]
}
}
}
}McpServers
{
"mcp_jira": {
"command": "uv",
"args": [
"venv"
]
}
}MCP JIRA Server
A Model Context Protocol (MCP) server that provides seamless JIRA integration for AI tools. Create and manage JIRA issues with rich markdown formatting, automatic conversion to Atlassian Document Format (ADF), and flexible field management.
Overview
This MCP server enables AI assistants to interact directly with JIRA instances through the JIRA REST API v3. It handles the complexity of markdown-to-ADF conversion, field mapping, and multi-site configuration, allowing AI tools to create well-formatted JIRA issues with minimal setup.
Key architectural components:
- MCP Server: FastMCP-based server with stdio/SSE transport support
- JIRA Client: Direct REST API integration with authentication handling
- Markdown Converter: Converts markdown to Atlassian Document Format (ADF)
- Configuration System: Multi-site JIRA configuration with flexible site selection
- Field Management: Support for both standard and custom JIRA fields
Features
- Rich Markdown Support: Convert markdown descriptions to properly formatted ADF with support for:
- Headers, paragraphs, and text formatting (bold, italic, inline code)
- Fenced code blocks with syntax highlighting
- Bullet and numbered lists
- Tables and complex formatting elements
- Flexible Field Management:
- Create and update JIRA issues with standard fields: project, summary, description, issue type.
- Robust assignee handling: Provide an email address, and the server resolves it to the correct JIRA accountId for reliable assignment.
- additional_fields parameter supports labels, priority, due dates, and other custom fields.
- Graceful degradation for unavailable fields across different JIRA configurations.
- Multi-Site Configuration: Support for multiple JIRA instances with site aliases, configurable in config.yaml.
- Comprehensive Error Handling: Detailed error messages and logging.
- Transport Flexibility: Support for both stdio and SSE transport modes.
Installation
From Source
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
