Jira MCP Server

Features

• Create new issues (Tasks, Epics, Subtasks)

• List issues with optional status filtering

• Update existing issues (summary, description, status)

• Get detailed issue information

• Delete issues

• Add comments to issues

Setup

Prerequisites

1. A Jira account with API access

2. Jira API token (can be generated from [Atlassian Account Settings](https://id.atlassian.com/manage-profile/security/api-tokens))

Installation

1. Install dependencies:

1. Build the server:

Configuration

1. Create a `.jira-config.json` file in your working directory:

1. Configure the MCP server with your Jira credentials:

Available Tools

create_issue

• Required parameters: - working_dir: Directory containing .jira-config.json - summary: Issue title - description: Issue description - type: Issue type (Task, Epic, or Subtask)

list_issues

• Required parameters: - working_dir: Directory containing .jira-config.json

• Optional parameters: - status: Filter by status (e.g., "To Do", "In Progress", "Done")

update_issue

• Required parameters: - working_dir: Directory containing .jira-config.json - issue_key: Issue key (e.g., PRJ-123)

• Optional parameters: - summary: New title - description: New description - status: New status

get_issue

• Required parameters: - working_dir: Directory containing .jira-config.json - issue_key: Issue key (e.g., PRJ-123)

delete_issue

• Required parameters: - working_dir: Directory containing .jira-config.json - issue_key: Issue key (e.g., PRJ-123)

add_comment

• Required parameters: - working_dir: Directory containing .jira-config.json - issue_key: Issue key (e.g., PRJ-123) - comment: Comment text to add

Development

Error Handling

• Invalid project keys

• Missing configuration

• Invalid issue types

• API authentication errors

• Invalid status transitions

Output Formatting

• Issue key and summary

• Issue type and status

• Creation date and creator

• Description

• Comments (if any) with author and timestamp