jira-self-hosted-mcp

A Model Context Protocol (MCP) server for Jira Server / Data Center 9.0+.

Expose your self-hosted Jira to any MCP-compatible AI client (Claude Desktop, Cursor, etc.) so it can search, read, create and assign issues on your behalf using JQL.

Not for Jira Cloud (*.atlassian.net). Users are identified by Jira username (name), not accountId.

Features

17 MCP tools covering the most common Jira workflows:

| Tool | Description | |------|-------------| | search-issues | Search issues with a JQL query | | get-issue | Get detailed info about a single issue | | get-comments | Get all comments on an issue | | add-comment | Add a comment to an issue | | update-comment | Update an existing comment | | delete-comment | Delete a comment from an issue | | create-issue | Create a new issue | | update-issue | Update fields of an existing issue (summary, description, priority, due date, labels) | | assign-issue | Assign / unassign an issue | | get-transitions | Get available status transitions for an issue | | transition-issue | Transition an issue to a new status (e.g., mark as done) | | get-priorities | List all issue priorities | | add-worklog | Add a worklog (time tracking entry) to an issue | | get-worklogs | Get all worklogs for an issue | | update-worklog | Update an existing worklog | | delete-worklog | Delete a worklog from an issue | | watch-issue | Start watching an issue | | unwatch-issue | Stop watching an issue | | get-issue-types | List issue types for a project | | get-projects | List projects | | get-users | List users | | get-labels | List labels | | get-teams | List teams | | get-myself | Get the authenticated user |

Setup

1. Build

git clone https://gitee.com/houmingming/jira-self-hosted-mcp.git
cd jira-self-hosted-mcp
npm install
npm run build

2. Configure via environment variables

| Variable | Required | Description | |----------|----------|-------------| | JIRA_BASE_URL | yes | Jira URL, e.g. https://jira.company.com | | JIRA_TOKEN | yes | Password or Personal Access Token (PAT) | | JIRA_AUTH_TYPE | no | basic (default) or bearer (PAT, Jira Data Center 9+) | | JIRA_USERNAME | yes if basic | Jira login name | | JIRA_INSECURE_SSL | no | true to trust self-signed certificates |

3. Add to your MCP client

Claude Desktop / Cursor (claude_desktop_config.json)

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/absolute/path/to/jira-self-hosted-mcp/dist/index.js"],
      "env": {
        "JIRA_BASE_URL": "https://jira.company.com",
        "JIRA_AUTH_TYPE": "bearer",
        "JIRA_TOKEN": "YOUR_PAT"
      }
    }
  }
}

Or run via npx (once published to npm)

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "jira-self-hosted-mcp"],
      "env": {
        "JIRA_BASE_URL": "https://jira.company.com",
        "JIRA_AUTH_TYPE": "bearer",
        "JIRA_TOKEN": "YOUR_PAT"
      }
    }
  }
}

License

MIT