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 : 32

update time : 2025-04-29

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 queriesRun JQL queries to get a list of tasks under specific conditions.

Get task names and descriptionsExtract only task names and description information.

Create tasksCreate new Jira tasks in the specified project.

List projectsDisplay available Jira projects and their related information.

Delete tasksRemove the specified tasks from Jira.

Edit tasksUpdate the summary, description, or other attributes of a task.

Get all statusesList all available statuses in Jira.

Assign tasksAssign tasks to specific users.

Find assignable usersSearch for assignable users of a project.

Add attachmentsAdd external files or links to tasks.

Advantages and limitations

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 tasksUse the execute_jql function to query unassigned tasks.

Create a new taskCreate 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"
      }
    }
  }
}