JIRA MCP Integration

A Model Context Protocol server for integrating JIRA with Claude. This tool allows Claude to create JIRA tickets directly within your conversations.

Features

Create JIRA tickets with summary, description, and issue type
Seamless integration with Claude desktop application
Simple configuration using Claude's desktop configuration file

Installation

Clone the repository:

git clone https://github.com/MankowskiNick/jira-mcp.git
cd jira-mcp

Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```

Configuration

Claude Desktop Configuration

Add the JIRA MCP server configuration to your claude_desktop_config.json file. This file is typically located at:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Roaming\Claude\claude_desktop_config.json

Add the following configuration to the file:

{
  "mcpServers": {
    "jira-mcp": {
      "command": "node",
      "args": ["/path/to/project/build/index.js"],
      "env": {
        "JIRA_HOST": "your-site.atlassian.net",
        "JIRA_USERNAME": "your-email@example.com",
        "JIRA_API_TOKEN": "your_api_token",
        "JIRA_PROJECT_KEY": "your_project_key",
        "USE_NON_CPP": "false"
      }
    }
  }
}

Replace the placeholder values with your actual JIRA information:

/path/to/project/build/index.js: Full path to the built index.js file
JIRA_HOST: Your JIRA instance domain (e.g., company.atlassian.net)
JIRA_USERNAME: Your JIRA username (usually your email address)
JIRA_API_TOKEN: Your JIRA API token (see below for how to get this)
JIRA_PROJECT_KEY: The key for your JIRA project (e.g., SCRUM, DEV, etc.)
USE_NON_CPP: Set to "true" to use "Non-CPP" for the customfield_10636 field, or "false" (default) to use "CPP"

Available Tools

create-ticket

Creates a new JIRA ticket.

Parameters:

summary: The title/summary of the ticket (required)
issue_type: The type of issue (Bug, Task, or Story, defaults to Task)
description: Detailed description of the ticket (optional)

read-ticket

Retrieves the details of an existing JIRA ticket. Parameters:

ticket_id: The ID of the JIRA ticket you want to read (required)

Usage with Claude

Once configured properly, you can ask Claude to create JIRA tickets directly:

Please create a JIRA ticket to track the database performance issue we discussed.

Claude will use the create-ticket tool to generate a ticket in your JIRA project.

Getting a JIRA API Token

Log in to your Atlassian account at https://id.atlassian.com/manage-profile/security
Go to Security > API tokens
Click "Create API token"
Give your token a name (e.g., "Claude Integration")
Click "Create"
Copy the token (you won't be able to see it again)

Troubleshooting

If you encounter issues:

Check that your JIRA credentials are correct
Verify the path to the project's index.js file in your claude_desktop_config.json
Make sure you've given Claude permission to use tools
Check Claude's console logs for any error messages related to the JIRA MCP server

jira-mcp