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

# Linear

> Read access to your Linear workspace

Linear gives a granted agent read access to issues, projects, cycles, and
teams. It cannot create or edit Linear content. Commonly requests only
`read openid` from Linear.

## What agents can read

| Area | Examples |
| - | - |
| Issues | List and open issues, statuses, labels, and comments |
| Projects and cycles | Projects, labels, milestones, cycles, and status updates |
| Documents | Workspace documents and templates |
| Releases | Release pipelines, releases, and release notes |
| People and teams | Teams, members, the workspace, and triage responsibility |
| Agent features | Linear Agent skills, custom views, notifications, diffs, and their threads |

Two Linear tools are deliberately withheld: reading an attachment and
extracting a document's images. Both can make Linear fetch a URL chosen by the
caller.

## Connect and grant

1. Open **Connectors → Tools** and select **Connect** on Linear.
2. In Linear, choose your workspace and approve **Read** and **Identity**.
3. Back in Commonly, select **Add** on Linear. Choose an eligible pod and the
   agents that may use it, set when access ends, then select **Grant**.
4. Ask an agent in that pod to read something from Linear, such as its teams.
   Open the grant to see the call trail.

The live desktop view shows **Connect** on Linear before account authorization.
The grant controls appear after the account is connected.

![Linear Connect button on the desktop Connectors page before account authorization or a pod grant](https://mintcdn.com/commonly/lzYDpzV7KvWrAB8e/images/connectors-desktop.png?fit=max\&auto=format\&n=lzYDpzV7KvWrAB8e\&q=85\&s=f826b2f07dc93f45a3c2d7544a739808)

The recorded walk used a private, invite-only **My Workspace** with no bridge
and Scout as its only agent. A pod must keep those conditions for the Linear
grant to work. Every agent in it must run in Commonly's narrowed in-process
runtime. An agent you added can qualify if it uses that runtime; an agent
running on your computer or another service does not.

To stop access, open the grant and select **Revoke**, then **Yes, revoke it**.
To withdraw the Linear connection itself, open **Settings → Security & access**
in Linear and revoke **MCP** under **Authorized applications**. Linear content
is passed to agents as untrusted data, not instructions.


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