Jira MCP Server

A TypeScript-based MCP server for interacting with Jira, providing functions such as querying, creating, and managing Jira tickets.

Developer tools Customer support #Jira tools #Ticket management #Project collaboration Remote .TypeScript

rating : 2.5 points

downloads : 4.3K

update time : 2025-04-29

Open Site

What is the Jira Communication Server?

The Jira Communication Server is a TypeScript-based MCP server designed to simplify interactions with Jira. It offers various tools to perform JQL queries, create and modify Jira tasks, list projects and statuses, etc.

How to use the Jira Communication Server?

By configuring the server environment variables and running the relevant commands, you can easily interact with Jira. Supported functions include querying tasks, creating new tasks, editing existing tasks, etc.

Applicable scenarios

Suitable for task teams that need to operate Jira frequently, such as software developers, project managers, and technical support staff.

Main features

Execute JQL queries

Run JQL queries to get a list of tasks under specific conditions.

Get task names and descriptions

Extract only task names and description information.

Create tasks

Create new Jira tasks in the specified project.

List projects

Display available Jira projects and their related information.

Delete tasks

Remove the specified tasks from Jira.

Edit tasks

Update the summary, description, or other attributes of a task.

Get all statuses

List all available statuses in Jira.

Assign tasks

Assign tasks to specific users.

Find assignable users

Search for assignable users of a project.

Add attachments

Add external files or links to tasks.

Advantages

Quickly integrate with the Jira API without manual coding.

Support multiple common operations to improve work efficiency.

Easy to configure and deploy, suitable for team collaboration.

Limitations

Depends on the Jira API and may be subject to permission restrictions.

Some advanced features may require additional configuration.

There may be limitations on performance for large-scale data processing.

How to use

Install dependencies

Run `npm install` to install the necessary dependencies.

Build the server

Build the server to generate an executable file.

Start the server

Start the server and begin interacting with Jira.

Usage examples

Query unassigned tasks

Use the execute_jql function to query unassigned tasks.

Create a new task

Create a new Jira task through the create_ticket function.

Frequently Asked Questions

How to set the environment variables for the Jira Communication Server?

How to debug the MCP server?

Related resources

MCP Inspector

A tool for debugging MCP servers.

Jira API documentation

The official documentation of the Jira API.

🚀 Jira Communication Server MCP Server

This is a TypeScript-based MCP server that provides tools for interacting with Jira. It demonstrates the MCP concept through the following core features:

Tools for executing JQL queries
Tools for creating, editing, and deleting Jira tickets
Tools for listing Jira projects and statuses

✨ Features

Jira Tools

`execute_jql`

Purpose: Run a JQL query.
Parameters: jql, number_of_results (Default: 1).

`get_only_ticket_name_and_description`

Purpose: Get the ticket name and description.
Parameters: jql, number_of_results (Default: 1).

`create_ticket`

Purpose: Create a Jira ticket.
Parameters: project.key, summary, description, issuetype.name, parent (Optional).

`list_projects`

Purpose: List Jira projects.
Parameters: number_of_results (Default: 1).

`delete_ticket`

Purpose: Delete a ticket.
Parameters: issueIdOrKey.

`edit_ticket`

Purpose: Modify a ticket.
Parameters: issueIdOrKey, summary (Optional), description (Optional), labels (Optional), parent (Optional).

`get_all_statuses`

Purpose: Get all statuses.
Parameters: number_of_results (Default: 1).

`assign_ticket`

Purpose: Assign a ticket to a user.
Parameters: accountId, issueIdOrKey.

`query_assignable`

Purpose: Find assignable users in a project.
Parameters: project_key.

`add_attachment`

Purpose: Add an attachment to a ticket.
Parameters: issueIdOrKey, imageUrl.

📦 Installation

Development

Install dependencies:

npm install

Build the server:

npm run build

Development with automatic rebuild:

npm run watch

Configuration

When using with Claude Desktop, add the server configuration:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "Jira communication server": {
      "command": "node",
      "args": [
        "/PATH_TO_THE_PROJECT/build/index.js"
      ],
      "env": {
        "JIRA_URL": "https://XXXXXXXX.atlassian.net",
        "JIRA_API_MAIL": "Your email",
        "JIRA_API_KEY": "KEY_FROM : https://id.atlassian.com/manage-profile/security/api-tokens"
      }
    }
  }
}