Jira mcp

MCP server for Jira Server/Data Center (REST API v2). Lets an AI assistant (Claude Code, Claude Desktop, ...) read and write your Jira directly.

Requirements

• A Jira Server/Data Center account (username + password).

• Node.js 18+.

Related MCP server: Jira MCP Server

Quick start

Use Claude Code CLI:

claude mcp add jira-mcp npx -y g-jira-mcp@latest \
  --env JIRA_HOST="https://jira.company.com" \
  --env JIRA_USERNAME="your_username" \
  --env JIRA_PASSWORD="your_password"

Or manually add to .claude/settings.json (or claude_desktop_config.json):

{
  "mcpServers": {
    "jira-mcp": {
      "command": "npx",
      "args": ["-y", "g-jira-mcp@latest"],
      "env": {
        "JIRA_HOST": "https://jira.company.com",
        "JIRA_USERNAME": "your_username",
        "JIRA_PASSWORD": "your_password"
      }
    }
  }
}

Restart Claude Code/Desktop after editing the config.

Environment variables

To discover custom field IDs on your instance:

curl -u user:pass https://jira.company.com/rest/api/2/field | jq '.[] | select(.name | test("story|point|start"; "i")) | {id, name}'

Tools

Notes

• Jira Server uses plain text for descriptions — no ADF format.

• duedate is a standard field (YYYY-MM-DD); "Start date" is a custom field, configurable via JIRA_START_DATE_FIELD.

• search_tickets uses JQL syntax, e.g. project = GEM AND status = 'In Progress'.

• transition_ticket matches the target status by name and resolves the transition ID automatically.

• update_ticket only changes the fields you pass; omit a field to keep its current value. Pass assignee="" to unassign. implementation_notes appends to the description.

• generate_release_notes groups tickets by type into Features / Improvements / Bug Fixes / Other.

• All logs go to stderr; stdout is reserved for the MCP protocol.

Example prompts

• "Search tickets in project GEM that are In Progress"

• "Create a Story in GEM titled 'Release notes v2.0' due 2026-08-01"

• "Update GEM-234, set the assignee to namcp and add label BugFix"

• "Add a comment to GEM-234: 'Review done'"

• "Generate release notes for fix version v2.4 in project GEM"

Troubleshooting

• 401/403: recheck JIRA_USERNAME/JIRA_PASSWORD and whether the account can access the project.

• Connection/timeout: verify JIRA_HOST format (starts with https://, no trailing /), and whether VPN/internal network is required.

• Start date not saving: confirm JIRA_START_DATE_FIELD matches your instance (see the discovery command above).

• No error logs: server logs go to stderr — check the MCP client (Claude Code/Desktop) output, not stdout.

Development

pnpm install
cp .env.example .env   # edit with your credentials
pnpm build             # bundle to dist/index.js via esbuild
pnpm lint              # biome check + tsc + prettier (markdown)
pnpm release           # release-it: bumps version, commits, tags, pushes (runs lint + build first, no pre-commit needed)
pnpm archive           # package release/jira-mcp-v<version>.zip

Support

Questions or issues? Email NamCP.

If this project helps you, consider buying me a coffee: