Jira MCP Server

A Model Context Protocol (MCP) server for interacting with Jira's API. Provides tools for managing issues, projects, and workflows.

Features

• Create, update, and delete Jira issues
• List issues with JQL filtering
• Manage issue links and relationships
• Get project metadata (fields, issue types, etc.)
• User account lookup

Installation

1. Clone this repository
2. Install dependencies:

npm install

3. Create a .env file with your Jira credentials:

# Your Jira instance URL (e.g., https://company.atlassian.net)
JIRA_HOST=your-instance.atlassian.net
# Your Jira account email
JIRA_EMAIL=your-email@example.com
# Personal Access Token generated from Atlassian account settings
JIRA_API_TOKEN=your-api-token

Configuration

For Cursor

Add to Cursor MCP settings in ~/.cursor/mcp.json:

{
  "mcpServers": {
    "jira-mcp": {
      "type": "command",
      "autoApprove": ["get_issues", "get_assigned_issues", "create_issue"],
      "disabled": false,
      "timeout": 180,
      "command": "node",
      "args": ["/Path/To/jira-mcp/build/index.js"],
      "env": {
        "JIRA_HOST": "You Jira host",
        "JIRA_API_TOKEN": "Jira personal access token",
        "JIRA_EMAIL": "Your Jira email",
        "NODE_ENV": "production"
      },
      "transportType": "stdio",
      "models": ["*"]
    }
  }
}

For more information on generating an API token, read the PAT documentation in Jira.

Available Tools

delete_issue

Delete a Jira issue or subtask by issue key.

Parameters:

• issueKey (string): Key of the issue to delete (e.g., "PROJ-123")

get_issues

Get all issues and subtasks for a project or rapid view.

Parameters:

• projectKey (string): Project key (e.g., "PROJ")
• OR rapidView (number|string): Rapid view ID
• jql (string, optional): JQL query to filter issues

get_assigned_issues

Get issues assigned to a user, with options to filter by assignment status.

Parameters:

• accountId (string): The account ID of the user. Use get_user to find this.
• status (string, optional): Filter by assignment status: "current" (default), "past", or "all".
• additionalJql (string, optional): Optional JQL to further filter issues (e.g., project = "PROJ" AND updated > -1d).

update_issue

Update fields of an existing Jira issue.

Parameters:

• issueKey (string): Key of the issue to update
• summary (string, optional): New summary/title
• description (string, optional): New description
• assignee (string, optional): Account ID of new assignee
• status (string, optional): New status name
• priority (string, optional): New priority name

create_issue

Create a new Jira issue.

Parameters:

• projectKey (string): Project key
• summary (string): Issue summary/title
• issueType (string): Issue type name
• description (string, optional): Detailed description
• assignee (string, optional): Account ID of assignee
• labels (array, optional): Array of labels
• components (array, optional): Array of component names
• priority (string, optional): Priority name

create_issue_link

Create a relationship between two Jira issues.

Parameters:

• inwardIssueKey (string): Key of inward issue
• outwardIssueKey (string): Key of outward issue
• linkType (string): Name of link type

Development

Build the project:

npm run build

Run tests:

npm test

Start the server:

npm start

Use the MCP Inspector to test the server:

npm run inspector

Technical Details

• Uses Model Context Protocol SDK version 1.18.0
• Compatible with Cursor and other MCP-enabled AI assistants
• Built with TypeScript and Node.js