jira-mcp

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)

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

| Variable | Required | Description | |---|---|---| | JIRA_EMAIL | Yes | Your Atlassian account email | | JIRA_API_TOKEN | Yes | The API token you generated above | | JIRA_BASE_URL | No | Defaults to https://openmrs.atlassian.net |

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

| Tool | Description | Key Parameters | |---|---|---| | createJiraIssue | Create a new issue | projectKey, summary, issueType, description, priority, labels, assigneeAccountId | | getJiraIssue | Fetch an issue by key/ID | issueIdOrKey, fields | | editJiraIssue | Update fields on an issue | issueIdOrKey, summary, description, priority, labels, assigneeAccountId, issueType | | searchJiraIssues | Search with JQL | jql, maxResults, fields | | addCommentToJiraIssue | Add a comment | issueIdOrKey, body | | getTransitionsForJiraIssue | List available transitions | issueIdOrKey | | transitionJiraIssue | Move issue to new status | issueIdOrKey, transitionId | | getVisibleJiraProjects | List visible projects | maxResults | | getJiraIssueTypeMetaWithFields | Get create metadata for a project/issue type | projectIdOrKey, issueTypeId | | lookupJiraAccountId | Search users by name/email | query, maxResults |

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