Jira MCP Server

A Model Context Protocol (MCP) server for interacting with Jira's REST API using the jira-python library. This server integrates with Claude Desktop and other MCP clients, allowing you to interact with Jira using natural language commands.

Features

• Get all accessible Jira projects

• Get details for a specific Jira issue

• Search issues using JQL (Jira Query Language)

• Create new Jira issues

• Add comments to issues

• Get available transitions for an issue

• Transition issues to new statuses

Related MCP server: Jira MCP Server

Installation

Prerequisites

• Python 3.9 or higher

• A Jira instance (Cloud, Server, or Data Center)

• uv (optional but recommended for dependency management)

Activate a virtual environment (recommended)

Using uv (recommended)

Using pip

Configuration

Environment Variables

Configure the server using environment variables:

• JIRA_SERVER_URL: URL of your Jira server

• JIRA_AUTH_METHOD: Authentication method ('basic_auth' or 'token_auth')

• JIRA_USERNAME: Username for basic auth

• JIRA_PASSWORD: Password for basic auth

• JIRA_TOKEN: API token or Personal Access Token

Environment File (Local Development)

You can also create a .env file in the root directory with your configuration:

Usage

Command Line

Docker

Claude Desktop Integration

To use this server with Claude Desktop:

1. Install the server using one of the methods above

2. In Claude Desktop:

   • Go to Settings -> Developer

   • Click Edit Config

   • Open the json configuraiton in your editor of choice

   • Add the following JSON: (NOTE: The environment variables used are for token Auth and will not work with other authentication methods)

3. Now you can interact with Jira by asking Claude questions like:

   • "Show me all my projects in Jira"

   • "Get details for issue PROJECT-123"

   • "Create a new bug in the PROJECT with summary 'Fix login issue'"

   • "Find all open bugs assigned to me"

Authentication

The server supports multiple authentication methods:

Basic Authentication

For Jira Server/Data Center with username and password:

API Token (Jira Cloud)

For Jira Cloud using an API token:

Personal Access Token (Jira Server/Data Center)

For Jira Server/Data Center (8.14+) using a PAT:

Available Tools

1. get_projects: Get all accessible Jira projects

2. get_issue: Get details for a specific Jira issue by key

3. search_issues: Search for Jira issues using JQL

4. create_issue: Create a new Jira issue

5. add_comment: Add a comment to a Jira issue

6. get_transitions: Get available workflow transitions for a Jira issue

7. transition_issue: Transition a Jira issue to a new status

License

MIT