Jira MCP Server

What is Jira MCP Server?

Jira MCP Server is an enhanced Model Context Protocol (MCP) server that enables AI assistants like Claude to interact directly with a Jira instance for project management tasks. It is intended for users of Claude Desktop or other MCP-compatible AI assistants.

How to use Jira MCP Server?

Install by cloning the repository, installing dependencies with npm install, and setting environment variables (JIRA_HOST, JIRA_EMAIL, JIRA_API_TOKEN) in a .env file. Build with npm run build, start with npm start. Then add the server to Claude Desktop’s configuration file (located at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS) with the appropriate command and environment variables.

Key features of Jira MCP Server

• Full Jira API integration for comprehensive access
• Enhanced Markdown to Atlassian Document Format conversion
• Input validation using Zod schemas
• Improved error handling with detailed messages
• Custom Jira field configuration support
• Advanced workflow and status transition management
• Bulk issue operations (updates, deletions)
• Granular label and component management (add, remove, replace)
• Configurable logging via LOG_LEVEL environment variable

Use cases of Jira MCP Server

• Retrieve project information and list issue types
• Create and update issues and subtasks with custom fields
• Manage issue workflows with status transitions
• Add comments with formatting and visibility restrictions
• Perform bulk updates, deletions, and label/component modifications
• Link issues and manage dependencies

FAQ from Jira MCP Server

What are the prerequisites to use Jira MCP Server?

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

How do I configure custom Jira fields?

Add custom field IDs (e.g., customfield_10001) to the JIRA_CUSTOM_FIELDS environment variable, then use the customFields parameter in requests with appropriate value formats (text, select, user, multi-select, date).

Where is the Claude Desktop configuration file located?

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json. Windows: %APPDATA%/Claude/claude_desktop_config.json. Linux: ~/.config/Claude/claude_desktop_config.json.

What logging levels are available?

LOG_LEVEL can be set to debug, info, warn, or error. Default is info.

How does error handling work?

The server provides detailed error messages for invalid parameters,