Jira MCP Server

A Model Context Protocol (MCP) server for Jira integration, enabling AI assistants to interact with Jira instances through simple, direct configuration.

Quick Start (No Installation Required)

You do not need to install this package manually. Simply configure your MCP-compatible assistant (such as Claude Desktop or Cursor IDE) to use Jira MCP as a server. The assistant will automatically invoke Jira MCP via npx when needed.

Simple MCP Configuration (Recommended)

Add the following to your MCP configuration file (e.g., for Cursor or Claude Desktop):

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "@deoo/jira-mcp"],
      "env": {
        "JIRA_HOST": "your-domain.atlassian.net",
        "JIRA_PROTOCOL": "https",
        "JIRA_USERNAME": "your_username",
        "JIRA_PASSWORD": "your_password",
        "JIRA_API_VERSION": "2"
      }
    }
  }
}

• No installation required: The above works out-of-the-box with npx.
• No global or local npm install needed.
• Just configure and use!

Environment Variables Reference

| Variable | Required | Description | Example | |--------------------|-----------------|---------------------------------------------|----------------------------| | JIRA_HOST | Yes | Jira instance hostname (no protocol) | your-domain.atlassian.net| | JIRA_PROTOCOL | No (default: https) | Protocol to use | https | | JIRA_USERNAME | For Basic Auth | Your Jira username | your_username | | JIRA_PASSWORD | For Basic Auth | Your Jira password | your_password | | JIRA_API_VERSION | No (default: 2) | Jira API version | 2 |

Available Tools

• add-comment: Add a comment to an issue
• add-issue-to-sprint: Add an issue to a sprint in Jira
• create-issue: Create a new issue in Jira
• edit-issue: Edit an existing issue in Jira
• list-boards: List Jira boards, optionally filtering by name or project
• list-issues: List issues from Jira
• list-sprints: List sprints for a given board

Local Development

If you want to contribute or run the server from source, follow these steps:

1. Clone the repository:

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

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

4. Run the server:

   npm run start

5. Install globally:

   npm install -g .