Jira

by vurtnec

3 stars
1 downloads
Not rated
GitHub

About

Model Context Protocol (MCP) server for Jira Cloud products. This integration is designed specifically for Jira Cloud instances and does not support Jira Server or Data Center deployments.

Details

Author
vurtnec
Repository
vurtnec/mcp-jira
GitHub stars
3
Downloads
1
Categories
Workplace

- Search and read Jira issues

Setting up with Highlight

Follow these steps to add this server as a custom Highlight plugin:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Jira
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 /your/project/path/mcp-jira
    • Argument 3 --jira-url
    • Argument 4 https://your-domain.atlassian.net
    • Argument 5 --jira-username
    • Argument 6 your.email@domain.com
    • Argument 7 --jira-api-token
    • Argument 8 your_api_token

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

1. Get API tokens from: https://id.atlassian.com/manage-profile/security/api-tokens

2. Add to your claude_desktop_config.json:

3. Git clone this repo and run npm install

4. Run npm run build

{
  "mcpServers": {
    "jira": {
    "command": "npx",
    "args": [
        "-y",
        "/your/project/path/mcp-jira",
        "--jira-url",
        "https://your-domain.atlassian.net",
        "--jira-username",
        "your.email@domain.com",
        "--jira-api-token",
        "your_api_token"
    ]
    }
  }
}

Replace /your/project/path/mcp-jira with the actual path where you've cloned the repository.

jira_get_issue

Get details of a specific Jira issue. Inputs: issue_key (string): Jira issue key (e.g., 'PROJ-123'), expand (string, optional): Fields to expand.

Jira Tools

- jira_get_issue
- Get details of a specific Jira issue
- Inputs:
- issue_key (string): Jira issue key (e.g., 'PROJ-123')
- expand (string, optional): Fields to expand

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "jira": {
            "cwd": "/your/project/path/mcp-jira",
            "env": {},
            "args": [
                "-y",
                "/your/project/path/mcp-jira",
                "--jira-url",
                "https://your-domain.atlassian.net",
                "--jira-username",
                "your.email@domain.com",
                "--jira-api-token",
                "your_api_token"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "cwd": "/your/project/path/mcp-jira",
    "env": [],
    "args": [
        "-y",
        "/your/project/path/mcp-jira",
        "--jira-url",
        "https://your-domain.atlassian.net",
        "--jira-username",
        "your.email@domain.com",
        "--jira-api-token",
        "your_api_token"
    ],
    "command": "npx"
}

Macos

{
    "cwd": "/your/project/path/mcp-jira",
    "env": [],
    "args": [
        "-y",
        "/your/project/path/mcp-jira",
        "--jira-url",
        "https://your-domain.atlassian.net",
        "--jira-username",
        "your.email@domain.com",
        "--jira-api-token",
        "your_api_token"
    ],
    "command": "npx"
}

Windows

{
    "cwd": "/your/project/path/mcp-jira",
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "/your/project/path/mcp-jira",
        "--jira-url",
        "https://your-domain.atlassian.net",
        "--jira-username",
        "your.email@domain.com",
        "--jira-api-token",
        "your_api_token"
    ],
    "command": "cmd"
}

MCP Jira

Model Context Protocol (MCP) server for Jira Cloud products. This integration is designed specifically for Jira Cloud instances and does not support Jira Server or Data Center deployments.

Features

- Search and read Jira issues

API

Tools

Jira Tools

- jira_get_issue
- Get details of a specific Jira issue
- Inputs:
- issue_key (string): Jira issue key (e.g., 'PROJ-123')
- expand (string, optional): Fields to expand

Usage with Claude Desktop

1. Get API tokens from: https://id.atlassian.com/manage-profile/security/api-tokens

2. Add to your claude_desktop_config.json:

3. Git clone this repo and run npm install

4. Run npm run build

{
  "mcpServers": {
    "jira": {
    "command": "npx",
    "args": [
        "-y",
        "/your/project/path/mcp-jira",
        "--jira-url",
        "https://your-domain.atlassian.net",
        "--jira-username",
        "your.email@domain.com",
        "--jira-api-token",
        "your_api_token"
    ]
    }
  }
}

Replace /your/project/path/mcp-jira with the actual path where you've cloned the repository.

License

Licensed under MIT - see LICENSE file. This is not an official Atlassian product.

No reviews yet — be the first

Sign in to leave a review

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

Email sign in

No reviews posted yet.