# Connect Jira

Connect Jira so a Project or Metric goal tracks completed tickets in a Jira project or JQL query.

Connect Jira so a project goal moves as tickets close. Brev sees only the projects your Jira user can browse.

## What you get from Jira {#what-you-get}

- Goal progress from a Jira project, or from your own JQL query.
- Optional real-time updates when tickets change.
- The project's tickets listed on the goal page.

## Connect Jira {#connect}

1. In Settings, click **Connections**, then type Jira in **Search connections**.
2. On its row, click **Connect**.
3. Sign in to Atlassian and approve access.

> **Tip: Success check**
>
> The Jira row shows a **Connected** badge.

## Track a Jira project or query {#track}

1. Open a Project or Metric goal and click **Auto-track**. Under **Ready to track**, pick Jira.
2. Pick your Atlassian site and click **Continue**.
3. Under **Project**, pick the project. To write the query yourself, turn on **Advanced** and fill in **JQL Query**. A query must name a project, sprint, filter or similar scope.
4. Under **Track progress**, pick one. A Project goal offers **Completed tickets**. A Metric offers Tickets completed, as a count or a percent.
5. Optionally, turn on **Update in real time**.
6. Next to **Connect**, pick how often to refresh: Every 30 minutes (the default), Hourly, Every 4 hours, Daily or Weekly. Then click **Connect**.

![The Auto-track menu open on a goal: apps under Connect to track, with Request access beside the ones Brev can't track yet.](https://help.brev.io/doc-assets/screenshots/auto-track-a-goal-open-auto-track.png)

> **Tip: Success check**
>
> The goal shows the Jira icon on its connection, and its value updates without a check-in from you.

## After you connect Jira {#what-happens-next}

Brev reads the value at the frequency you picked. At Every 30 minutes, it reads every 30 minutes from 7 AM to 7 PM on weekdays (Sydney, New York or San Francisco time). Otherwise, it reads every 4 hours.

- To read it now, click the refresh icon on the goal's connection. An unchanged value adds no check-in.
- To see what it reads, hover over the connection or click its gear. The gear also changes the frequency.
- You can still add your own check-ins, for example to explain a change.

With **Update in real time** on, ticket changes land within seconds. It works only for a query that names a project.

On a Project goal, the goal page also lists the tracked project's issues, each with its status.

---

Use Brev from Claude, ChatGPT or Cursor with the Brev MCP server, https://mcp.brev.io/mcp: [set it up](https://help.brev.io/connect-ai-assistant/).