Skip to main content

Jira integration

Connect Jira so issues, sprints, and status history populate flow metrics.

The Jira integration is the most common planning-side data source for Leanmote. It powers throughput, cycle time, WIP, and waiting-time metrics, and contributes to Sprint Efficiency.

What Leanmote pulls from Jira

  • Projects you select.

  • Issues with full status-change history.

  • Sprints with start, end, and committed-scope snapshots.

  • Custom fields used in metrics (Story Points, Original Estimate).

Connect Jira

  1. Open Administration → Productivity Tools.

  2. Find Jira under Project Management and click Connect.

  3. Sign in with an Atlassian account that has access to the Jira site you want to integrate.

  4. Authorize the requested scopes (listed below).

  5. Select the projects to track. Less is more — start with active projects only.

  6. Click Save.

OAuth scopes requested

  • read:jira-work — read issues, sprints, and status history. This is the data that drives every metric.

  • read:jira-user — read user accounts so we can map Jira identities to Leanmote teammates.

  • read:me — read the connecting account's profile.

  • offline_access — refresh the access token in the background so the integration keeps syncing without re-authentication.

  • write:jira-work — required so Leanmote can post comments and apply transitions on your behalf when you opt into agentic features (for example, the Leanmote Bot answering documentation tickets in your project). Reporting and analytics never use this scope.

If your security team prefers to disable the agentic features, contact your account team — we can deploy a connection variant that omits write:jira-work, at the cost of those features.

Status mapping

For accurate cycle time, WIP, and rework metrics, Leanmote needs each Jira status mapped to one of four kinds: backlog, active/in-progress, waiting/review, or done.

Jira statuses are not auto-mapped on first sync. Until you configure a mapping, statuses are unmapped and Jira tasks may be missing from WIP, cycle-time, and backlog charts. Two ways to set the mapping:

  • AI-assisted — Leanmote can suggest a mapping based on each status's name. Open the Jira card in Administration → Productivity Tools and click the auto-map action; review and accept the suggestions.

  • Manual — assign each status to a kind directly from the same screen.

Sprints

If your Jira boards use sprints, Sprint Efficiency starts populating once two complete sprints have closed. Boards without sprints simply won't show that metric.

Common issues

  • Cycle time looks wrong — usually a status-mapping issue. Re-check active vs. waiting state assignment.

  • Tasks missing from charts — most charts skip tasks with unmapped statuses. Run the AI auto-mapper or finish manual mapping.

  • Permission errors — the connecting user must have project-level read access. Service-account installs avoid this.

Related articles

  • Integrations overview

  • Connect your first integrations

  • Why a metric looks off

Did this answer your question?