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

# Linear

> Search, create, and manage Linear issues and projects

## At a glance

* **Availability**: Enabled by default.
* **Auth**: OAuth 2.0.
* **Connection**: A user authorizes the connection in the provider's consent screen.
* **Scopes**: `read`, `write`.

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.

| Variable               | Required | Description                                                                                   |
| ---------------------- | -------- | --------------------------------------------------------------------------------------------- |
| `LINEAR_CLIENT_ID`     | Yes      | Linear OAuth Client ID (from your OAuth application) [Docs](https://linear.app/settings/api). |
| `LINEAR_CLIENT_SECRET` | Yes      | Linear OAuth Client Secret [Docs](https://linear.app/settings/api).                           |

## Tools

| Tool                 | Access | Description                                                                                             |
| -------------------- | ------ | ------------------------------------------------------------------------------------------------------- |
| Search Issues        | Read   | Search for Linear issues by title or description                                                        |
| Get Issue            | Read   | Get detailed information about a specific Linear issue                                                  |
| Create Issue         | Write  | Create a new Linear issue in a team                                                                     |
| Update Issue         | Write  | Update the status, assignee, or other properties of an issue                                            |
| Delete Issue         | Write  | Archive a Linear issue. By default this is non-permanent so canary-created issues do not remain active. |
| List Projects        | Read   | List all projects in the workspace                                                                      |
| List Teams           | Read   | List Linear teams in the workspace so issues can be created in the right team                           |
| List Workflow States | Read   | List workflow states for a Linear team so issues can be moved to the right status                       |
| List Users           | Read   | List Linear users in the workspace so issues can be assigned to the right person                        |
| Add Comment          | Write  | Add a comment to a Linear issue                                                                         |
| List Issue Labels    | Read   | List Linear issue labels so the right label IDs can be applied when creating or updating issues         |

## Example prompts

* Search for Linear issues assigned to me or related to a specific topic.
* Create a new bug report in Linear with title, description, and relevant labels.
* Update the status of a Linear issue (e.g., mark as done, in progress, blocked).
* Get an overview of all projects in Linear, including their status and key issues.