> ## Documentation Index
> Fetch the complete documentation index at: https://docs.custral.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear

> Let Stella find and read your Linear issues, projects and cycles.

## What it does

Linear connects as a **connector**: Stella, your AI teammate, can look things up in your Linear workspace when you ask. "What's blocking the importer project?", "Which issues in this cycle are assigned to me?" and "Summarize the open bugs labelled billing" are all answered from Linear itself.

Linear connects **per person**. Each teammate signs in with their own Linear account, and Stella sees only the issues, projects and cycles that person can see in Linear. Nothing is copied into Custral: Stella reads Linear at the moment you ask.

## Connect

**1. Find Linear**

Go to **Settings → AI and automations → Connectors** and find **Linear** under **Browse**. It also appears as a card
on **Settings → Integrations**, badged **Each person · for Stella**.

**2. Sign in to Linear**

Choose **Connect**. Linear's own consent screen opens. Approve it and you come back to Custral with Linear listed
under **Connected**.

**3. Ask Stella**

Stella can use Linear on your next message. To point it at Linear on purpose, type `/` in Stella and pick
**Linear**.

## Configure

Choose **Configure** on the connected row:

| Setting | What it does |
| - | - |
| **On** | Turn off to hide Linear's tools from Stella without disconnecting. |
| **Let Stella use write tools** | Off by default, so Linear starts read-only. When on, Stella can use tools that change data, such as filing an issue, and asks you before every one. Tools Linear marks destructive are never used. |
| **Tools** | Every tool Linear offers, marked *Read*, *Changes data* or *Destructive*. Turn off any you don't want Stella to use. |
| **Inbound events** | A URL you can set up in Linear to post events to. Each post fires the **Connector Event Received** workflow trigger. The URL holds its own secret, so it's shown once. |

## Resources synced

Nothing is synced. Linear stays the record of your issues.

| Linear resource | Custral surface |
| - | - |
| Issues, projects and cycles | Read by Stella when you ask, through Linear's own tools |
| Events Linear posts to the inbound URL | The **Connector Event Received** workflow trigger |

## Limitations

* Stella sees only what your Linear account can. A teammate who hasn't connected Linear gets no Linear answers, even if you have.
* Write tools are off until you turn them on, and every write asks first.
* Once Stella has read from Linear in a chat, it asks before writing anything back into Custral (a record, a note, a task), because anyone who can open that record would see what it read.
* Issues don't become Custral records. To link code to records, see [GitHub](https://docs.custral.com/integrations/github.md).

## Troubleshooting

| Symptom | Cause | Fix |
| - | - | - |
| "Connection cancelled" | Access wasn't granted on Linear's consent screen. | Choose **Connect** again and approve. |
| "Connection expired" | The sign-in took too long or was already finished. | Start the connection again from **Connectors**. |
| "Couldn't connect the server" | Linear didn't accept the connection. | Start connecting it again from **Settings → AI and automations → Connectors**. |
| The row says **Needs attention** | The last call to Linear failed. | Open **Configure** and reconnect to restore Stella's access. |
| The row says **Off** | The connector is switched off. | Turn **On** back on in **Configure**. |
| Stella won't file an issue | **Let Stella use write tools** is off, or that tool is turned off. | Turn write tools on, and check the tool's switch under **Tools**. |

## Disconnect

Open **Configure** and choose **Disconnect**. Stella loses access to Linear's tools until you connect it again. It only removes your own connection; teammates' connections stay.

## Related

* [Connectors](https://docs.custral.com/ai/mcp-connections.md): how connectors work, and adding your own.
* [Workflow triggers](https://docs.custral.com/automation/workflows/triggers.md): **Connector Event Received**.
* [GitHub](https://docs.custral.com/integrations/github.md): linking pull requests and commits to records.
* [Integrations overview](https://docs.custral.com/integrations/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.