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
Open
Administration → Productivity Tools.Find Jira under Project Management and click Connect.
Sign in with an Atlassian account that has access to the Jira site you want to integrate.
Authorize the requested scopes (listed below).
Select the projects to track. Less is more — start with active projects only.
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 Toolsand 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
