Jira MCP Server logo

Jira MCP Server

by fkesheh

The Jira MCP Server allows AI assistants like Claude to interact with Jira for project management tasks. It provides a Model Context Protocol interface for retrieving and manipulating Jira issues and projects.

View on GitHub

Last updated: N/A

What is Jira MCP Server?

The Jira MCP Server is an enhanced Model Context Protocol server designed to enable AI assistants, such as Claude, to directly interact with Jira. It allows for a wide range of project management tasks to be performed via AI, bridging the gap between natural language interaction and Jira's functionality.

How to use Jira MCP Server?

To use the server, you need to clone the repository, install dependencies, configure environment variables with your Jira credentials, build the server, and then start it. After starting the server, configure your MCP-compatible AI assistant (like Claude Desktop) to connect to the server by providing the server's address and necessary environment variables in the assistant's configuration file.

Key features of Jira MCP Server

  • Full Jira API Integration

  • Enhanced Formatting (Markdown to ADF)

  • Robust Input Validation (Zod)

  • Improved Error Handling

  • Custom Field Support

  • Status Transitions

  • Bulk Operations

  • Granular Label/Component Management

  • Configurable Logging

Use cases of Jira MCP Server

  • Retrieving project information and issues using natural language queries.

  • Creating and updating issues and subtasks through AI commands.

  • Managing issue workflows and transitions via AI-driven automation.

  • Creating issue links and dependencies using natural language instructions.

  • Automating user management and assignment tasks.

  • Performing bulk operations on issues for efficient project management.

FAQ from Jira MCP Server

What are the prerequisites for running the Jira MCP Server?

You need Node.js 18 or higher, a Jira Cloud or Server instance, a Jira API token (for Cloud) or username/password (for Server), and a Claude Desktop or other MCP-compatible AI assistant.

How do I configure Claude Desktop to use this server?

You need to locate your Claude Desktop configuration file (claude_desktop_config.json) and add the Jira MCP server configuration with the correct path to your cloned repository and your Jira credentials.

How do I work with custom Jira fields?

Add the custom field IDs to the JIRA_CUSTOM_FIELDS environment variable and then use them in your requests within the customFields object.

What kind of text formatting is supported?

The server supports enhanced Markdown-style formatting, including paragraphs, lists, headers, bold/italic text, code blocks, and more.

How can I troubleshoot authentication failures?

Ensure your JIRA_HOST, JIRA_EMAIL, and JIRA_API_TOKEN are correct. For Cloud instances, verify the API token was generated at https://id.atlassian.com/manage-profile/security/api-tokens.