home / mcp / jira mcp server

Jira MCP Server

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "brianstone-jira-mcp-server": {
      "command": "node",
      "args": [
        "path-to-repo/jira-mcp-server/build/index.js"
      ],
      "env": {
        "JIRA_API_KEY": "<YOUR_API_KEY>",
        "JIRA_USER_EMAIL": "[email protected]",
        "JIRA_PROJECT_KEY": "ABC",
        "JIRA_PROJECT_URL": "https://project-url.atlassian.net/rest/api/3"
      }
    }
  }
}

You can use this MCP server to connect your MCP client to Jira Cloud REST API endpoints, enabling you to manage issues and workflows from your MCP environment. It supports common Jira actions and is designed to work with Jira Cloud REST endpoints (/rest/api/3).

How to use

Once you have the server running, you will configure your MCP client to connect to it. The server is designed to be run locally or from a separate process and exposes functions that your MCP client can invoke to interact with Jira. You can create issues, search, assign, edit, transition, and archive issues using the available endpoints.

Key workflow patterns you can implement from your MCP client include: creating new issues with a default project key, searching for issues by key or criteria, updating issue fields, changing issue status, and assigning or unassigning issues to users. Ensure you provide the necessary Jira project URL, user email, API key, and default project key in your client configuration to authorize requests.

How to install

Prerequisites you need before installing: a Node.js runtime environment and npm.

Step by step commands to set up the server locally and prepare it for use.

# Step 1: Clone the project repository
# (Replace with your actual repository URL)
git clone <repository-url>
cd <repository-name>

# Step 2: Install dependencies
npm install

# Step 3: Build the project
npm run build

Configuration and start up

After building, start the MCP server using the runtime command shown in the setup example. You will run the server by invoking the built index file with Node and provide the required environment variables for Jira access.

# Example start command (adjust the path to your build index.js):
node path-to-repo/jira-mcp-server/build/index.js

MCP client configuration example

{
  "mcpServers": {
    "jira-mcp-server": {
      "command": "node",
      "args": ["path-to-repo/jira-mcp-server/build/index.js"],
      "env": {
        "JIRA_PROJECT_URL": "https://project-url.atlassian.net/rest/api/3",
        "JIRA_USER_EMAIL": "[email protected]",
        "JIRA_API_KEY": "yourAPIkey",
        "JIRA_PROJECT_KEY": "ABC"
      }
    }
  }
}

Available tools

Get Issue By Key

Retrieve a Jira issue by its key to view status, fields, and history.

Search Issues

Query Jira issues using JQL or simple criteria to list matching issues.

Create Issue

Create a new Jira issue in the specified project with default fields.

Assign Issue

Assign an issue to a user or change its assignee.

Unassign Issue

Remove the assignee from an issue or set it to unassigned.

Edit Issue

Update fields on an existing Jira issue.

Transition Issue

Move an issue through a Jira workflow to a new status.

Archive Issues

Archive or close multiple issues based on criteria.