Jira

by ks-gen-ai

17 stars

711 downloads

Not rated

GitHub

About

Integrates with Jira to enable automated ticket management, project oversight, and streamlined communication through JQL queries and comprehensive API operations.

Details

Author: ks-gen-ai
Repository: KS-GEN-AI/jira-mcp-server
GitHub stars: 17
Downloads: 711
License: MIT License
Categories: Productivity, Developer Tools, Design, Workplace, AI, Infrastructure, API, Project Management

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Jira

Command (node, npx, python, etc.) node
Arguments
- Argument 1 /PATH_TO_THE_PROJECT/build/index.js
Environment
- JIRA_URL https://XXXXXXXX.atlassian.net
- JIRA_API_KEY KEY_FROM : https://id.atlassian.com/manage-profile/security/api-tokens
- JIRA_API_MAIL Your email
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

To use with Claude Desktop, add the server config:

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"
      }
    }
  }
}

`execute_jql`

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

`get_only_ticket_name_and_description`

Fetch ticket name and description. Parameters: jql, number_of_results (default: 1).

`create_ticket`

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

`list_projects`

List Jira projects. Parameters: number_of_results (default: 1).

`delete_ticket`

Delete a ticket. Parameters: issueIdOrKey.

`edit_ticket`

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

`get_all_statuses`

Retrieve all statuses. Parameters: number_of_results (default: 1).

`assign_ticket`

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

`query_assignable`

Find assignable users in a project. Parameters: project_key.

`add_attachment_from_public_url`

Add an attachment from a public URL to a ticket. Parameters: issueIdOrKey, imageUrl.

`add_attachment_from_confluence`

Add an attachment from a Confluence page to a ticket. Parameters: issueIdOrKey, pageId, attachmentName.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

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

Jira communication server MCP Server

Talk to Jira

This is a TypeScript-based MCP server that provides tools to interact with Jira. It demonstrates core MCP concepts by providing:

- 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: Fetch 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: Retrieve 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_from_public_url`

- Purpose: Add an attachment from a public URL to a ticket.
- Parameters: issueIdOrKey, imageUrl.

`add_attachment_from_confluence`

- Purpose: Add an attachment from a Confluence page to a ticket.
- Parameters: issueIdOrKey, pageId, attachmentName.

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

To use with Claude Desktop, add the server config:

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"
      }
    }
  }
}

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

execute_jql

get_only_ticket_name_and_description

create_ticket

list_projects

delete_ticket

edit_ticket

get_all_statuses

assign_ticket

query_assignable

add_attachment_from_public_url

add_attachment_from_confluence

Claude Desktop / Cursor

Linux

Macos

Windows

Jira communication server MCP Server

Features

Jira Tools

execute_jql

get_only_ticket_name_and_description

create_ticket

list_projects

delete_ticket

edit_ticket

get_all_statuses

assign_ticket

query_assignable

add_attachment_from_public_url

add_attachment_from_confluence

Development

Installation

Debugging

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7

`execute_jql`

`get_only_ticket_name_and_description`

`create_ticket`

`list_projects`

`delete_ticket`

`edit_ticket`

`get_all_statuses`

`assign_ticket`

`query_assignable`

`add_attachment_from_public_url`

`add_attachment_from_confluence`

`execute_jql`

`get_only_ticket_name_and_description`

`create_ticket`

`list_projects`

`delete_ticket`

`edit_ticket`

`get_all_statuses`

`assign_ticket`

`query_assignable`

`add_attachment_from_public_url`

`add_attachment_from_confluence`