What is Jira Basic Mcp

jira-basic-mcp is a Model Context Protocol (MCP) server designed for interacting with Jira’s API. It provides tools for managing issues, projects, and workflows effectively.

Use cases

Use cases for jira-basic-mcp include automating issue management, integrating Jira with other tools, managing project workflows, and facilitating team collaboration through streamlined issue tracking.

How to use

To use jira-basic-mcp, clone the repository, install the dependencies using ‘npm install’, and create a .env file with your Jira credentials. Configure the MCP settings in your application to connect to the Jira API.

Key features

Key features include the ability to create, update, and delete Jira issues, list issues with JQL filtering, manage issue links and relationships, retrieve project metadata, and perform user account lookups.

Where to use

jira-basic-mcp can be used in software development environments, project management, and any organization that utilizes Jira for issue tracking and project management.

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:

JIRA_HOST=your-instance.atlassian.net
[email protected]
JIRA_PASSWORD=your-api-token

Configuration

Add to Cline MCP settings (usually in ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json):

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": [
        "/path/to/jira-basic-mcp/build/index.js"
      ],
      "env": {
        "JIRA_HOST": "your-instance.atlassian.net",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

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

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:

node build/index.js