jira-mcp

A local MCP server that wraps the Jira REST API v3 for openmrs.atlassian.net, providing a comprehensive alternative to the Atlassian Rovo MCP Server. Bypasses the Rovo server's "anonymous project" bug by calling the REST API directly with Basic Auth.

Prerequisites

• uv installed

• A Jira API token (see below)

Related MCP server: mcp-server-jira

Generating a Jira API Token

1. Go to https://id.atlassian.com/manage-profile/security/api-tokens

2. Click Create API token, give it a label (e.g. "Claude MCP"), and copy the token.

Environment Variables

Installation

Install as a tool so it's available as a standalone command:

uv tool install /absolute/path/to/jira-mcp

Replace /absolute/path/to/jira-mcp with the actual path to this directory. This creates a jira-mcp command (typically at ~/.local/bin/jira-mcp).

To update after pulling changes:

uv tool install --force /absolute/path/to/jira-mcp

Claude Desktop MCP Config

Add the following to your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux / WSL: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "jira": {
      "command": "jira-mcp",
      "env": {
        "JIRA_EMAIL": "you@example.com",
        "JIRA_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

If jira-mcp is not on Claude Desktop's PATH, use the full path (e.g. "/Users/you/.local/bin/jira-mcp").

Claude Code MCP Config

In your Claude Code settings (e.g. ~/.claude/settings.json), add:

{
  "mcpServers": {
    "jira": {
      "command": "jira-mcp",
      "env": {
        "JIRA_EMAIL": "you@example.com",
        "JIRA_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Tools

All description and comment body parameters accept Markdown, which is automatically converted to Atlassian Document Format (ADF) before sending.