# Connect Linear

Connect Linear so a Project or Metric goal tracks a Linear project's completed tasks or points.

Connect Linear so a project goal moves as its issues close. Operator can also read your Linear with the same login.

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

- Goal progress from a Linear project, by tasks or by points.
- Linear Project Updates posted on the goal as check-ins, if you turn that on.
- The project's issues listed on the goal page.

## Connect Linear {#connect}

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

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

## Track a Linear project {#track}

1. Open a Project or Metric goal and click **Auto-track**. Under **Ready to track**, pick Linear.
2. Pick the project and click **Continue**. For a number one project can't give, such as issues with a label, choose Describe a value beside the list instead.
3. Under **Track progress**, pick one. A Project goal offers **Completed tasks** or **Completed points**. A Metric offers Tasks or Points completed, as a count or a percent.
4. Optionally, turn on **Collect Project Updates**. It starts off. When on, each Project Update in Linear becomes a check-in, and a change to the project refreshes the goal within minutes.
5. 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 Linear icon on its connection, and its value updates without a check-in from you.

## After you connect Linear {#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.

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/).