Jira

by camdenclark

22 stars

4k downloads

Not rated

GitHub Website

About

Integrates Jira for natural language querying and manipulation of project management data.

Details

Author: camdenclark
Repository: CamdenClark/jira-mcp
GitHub stars: 22
Downloads: 3,978
License: MIT License
Categories: Productivity, Developer Tools, Design, AI, Community, Search, Knowledge Base, Infrastructure, Communication, Project Management, Other

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.) npx
Arguments
- Argument 1 -y
- Argument 2 jira-mcp
Environment
- JIRA_API_KEY your-api-token
- JIRA_USER_EMAIL your-email@company.com
- JIRA_INSTANCE_URL https://your-instance.atlassian.net
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_API_KEY": "your-api-token",
                "JIRA_USER_EMAIL": "your-email@company.com",
                "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net"
            },
            "args": [
                "-y",
                "jira-mcp"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_API_KEY": "your-api-token",
                "JIRA_USER_EMAIL": "your-email@company.com",
                "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "jira-mcp"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_API_KEY": "your-api-token",
                "JIRA_USER_EMAIL": "your-email@company.com",
                "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net"
            },
            "args": [
                "-y",
                "jira-mcp"
            ],
            "command": "npx"
        }
    }
}

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_API_KEY": "your-api-token",
                "JIRA_USER_EMAIL": "your-email@company.com",
                "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net"
            },
            "args": [
                "-y",
                "jira-mcp"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_API_KEY": "your-api-token",
                "JIRA_USER_EMAIL": "your-email@company.com",
                "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "jira-mcp"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_API_KEY": "your-api-token",
                "JIRA_USER_EMAIL": "your-email@company.com",
                "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net"
            },
            "args": [
                "-y",
                "jira-mcp"
            ],
            "command": "npx"
        }
    }
}

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_API_KEY": "your-api-token",
                "JIRA_USER_EMAIL": "your-email@company.com",
                "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net"
            },
            "args": [
                "-y",
                "jira-mcp"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_API_KEY": "your-api-token",
                "JIRA_USER_EMAIL": "your-email@company.com",
                "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "jira-mcp"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_API_KEY": "your-api-token",
                "JIRA_USER_EMAIL": "your-email@company.com",
                "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net"
            },
            "args": [
                "-y",
                "jira-mcp"
            ],
            "command": "npx"
        }
    }
}

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_API_KEY": "your-api-token",
                "JIRA_USER_EMAIL": "your-email@company.com",
                "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net"
            },
            "args": [
                "-y",
                "jira-mcp"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_API_KEY": "your-api-token",
                "JIRA_USER_EMAIL": "your-email@company.com",
                "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "jira-mcp"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_API_KEY": "your-api-token",
                "JIRA_USER_EMAIL": "your-email@company.com",
                "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net"
            },
            "args": [
                "-y",
                "jira-mcp"
            ],
            "command": "npx"
        }
    }
}

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_API_KEY": "your-api-token",
                "JIRA_USER_EMAIL": "your-email@company.com",
                "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net"
            },
            "args": [
                "-y",
                "jira-mcp"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_API_KEY": "your-api-token",
                "JIRA_USER_EMAIL": "your-email@company.com",
                "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "jira-mcp"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_API_KEY": "your-api-token",
                "JIRA_USER_EMAIL": "your-email@company.com",
                "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net"
            },
            "args": [
                "-y",
                "jira-mcp"
            ],
            "command": "npx"
        }
    }
}

From the repository

1. Log in to your Atlassian account at https://id.atlassian.com
2. Navigate to Security settings
3. Under API tokens, select "Create API token"
4. Give your token a meaningful name (e.g., "MCP Server")
5. Copy the generated token - you won't be able to see it again!
6. Use this token as your JIRA_API_KEY
7. Use the email address associated with your Atlassian account as JIRA_USER_EMAIL

To install JIRA for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install jira-mcp --client claude

1. Clone this repository:

git clone <repository-url>

cd jira-mcp

2. Install dependencies:

npm install

For testing and development, you can use the MCP Inspector:

npm run inspect

`jql_search`

Executes a JQL search query with customizable parameters. Parameters: jql (required), nextPageToken, maxResults, fields, expand.

`get_issue`

Retrieves detailed information about a specific issue. Parameters: issueIdOrKey (required), fields, expand, properties, failFast.

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "jira": {
            "env": {
                "JIRA_API_KEY": "your-api-token",
                "JIRA_USER_EMAIL": "your-email@company.com",
                "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net"
            },
            "args": [
                "-y",
                "jira-mcp"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": {
        "JIRA_API_KEY": "your-api-token",
        "JIRA_USER_EMAIL": "your-email@company.com",
        "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net"
    },
    "args": [
        "-y",
        "jira-mcp"
    ],
    "command": "npx"
}

Macos

{
    "env": {
        "JIRA_API_KEY": "your-api-token",
        "JIRA_USER_EMAIL": "your-email@company.com",
        "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net"
    },
    "args": [
        "-y",
        "jira-mcp"
    ],
    "command": "npx"
}

Windows

{
    "env": {
        "JIRA_API_KEY": "your-api-token",
        "JIRA_USER_EMAIL": "your-email@company.com",
        "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net"
    },
    "args": [
        "/c",
        "npx",
        "-y",
        "jira-mcp"
    ],
    "command": "cmd"
}

JIRA MCP Server

An MCP server that enables Large Language Models (LLMs) to interact with JIRA through standardized tools and context. This server provides capabilities for searching issues using JQL and retrieving detailed issue information.

Features

- JQL Search: Execute complex JQL queries with pagination support
- Issue Details: Retrieve detailed information about specific JIRA issues

Prerequisites

- npm installed
- A JIRA instance with API access
- JIRA API token or Personal Access Token
- JIRA user email associated with the API token

Getting JIRA API Credentials

Usage

Integration with Claude Desktop

1. Add the server configuration to Claude Desktop's config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "jira-mcp"],
      "env": {
        "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net",
        "JIRA_USER_EMAIL": "your-email@company.com",
        "JIRA_API_KEY": "your-api-token"
      }
    }
  }
}

2. Restart Claude Desktop to load the new configuration.

Available Tools

1. JQL Search (`jql_search`)

Executes a JQL search query with customizable parameters.

Parameters:
- jql (required): JQL query string
- nextPageToken: Token for pagination
- maxResults: Maximum number of results to return
- fields: Array of field names to include
- expand: Additional information to include

Example:

{

  "jql": "project = 'MyProject' AND status = 'In Progress'",

  "maxResults": 10,

  "fields": ["summary", "status", "assignee"]

}

2. Get Issue (`get_issue`)

Retrieves detailed information about a specific issue.

Parameters:
- issueIdOrKey (required): Issue ID or key
- fields: Array of field names to include
- expand: Additional information to include
- properties: Array of properties to include
- failFast: Whether to fail quickly on errors

Example:

{

  "issueIdOrKey": "PROJ-123",

  "fields": ["summary", "description", "status"],

  "expand": "renderedFields,names"

}

Development

Configuration

Set up your environment variables before running the server. Create a .env file in the root directory:

JIRA_INSTANCE_URL=https://your-instance.atlassian.net
JIRA_USER_EMAIL=your-email@company.com
JIRA_API_KEY=your-api-token

Replace the values with:
- Your actual JIRA instance URL
- The email address associated with your JIRA account
- Your JIRA API token (can be generated in Atlassian Account Settings)

Installation

Installing via Smithery

To install JIRA for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install jira-mcp --client claude

Manual Installation

1. Clone this repository:

git clone <repository-url>
cd jira-mcp

2. Install dependencies:

npm install

Running with MCP Inspector

For testing and development, you can use the MCP Inspector:

npm run inspect

Adding New Tools

To add new tools, modify the ListToolsRequestSchema handler in index.js:

server.setRequestHandler(ListToolsRequestSchema, async () => {
  return {
    tools: [
      // Existing tools...
      {
        name: "your_new_tool",
        description: "Description of your new tool",
        inputSchema: {
          // Define input schema...
        }
      }
    ]
  };
});

Then implement the tool in the CallToolRequestSchema handler.

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a PR.

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

jql_search

get_issue

Claude Desktop / Cursor

Linux

Macos

Windows

JIRA MCP Server

Features

Prerequisites

Getting JIRA API Credentials

Usage

Integration with Claude Desktop

Available Tools

1. JQL Search (jql_search)

2. Get Issue (get_issue)

Development

Configuration

Installation

Installing via Smithery

Manual Installation

Running with MCP Inspector

Adding New Tools

License

Contributing

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7

`jql_search`

`get_issue`

1. JQL Search (`jql_search`)

2. Get Issue (`get_issue`)