Skip to main content
When the agent proposes a linear_issue action (in write mode), Linear opens an issue in your team with the action title, rationale, and full context as the body.

​
Two setup options

See OAuth (recommended) for the cross-provider flow overview.

​
Option A — OAuth (one click)

After consent the agent stores the access token, captures the workspace name as oauth_account_label, and (when available) the first team id as config.teamId. Default scopes: read,write,issues:create. If you have multiple teams, override the team id afterwards:
Enable in preferences:
Done.

​
Option B — Personal API key (manual)

  1. In Linear: Settings → API → Personal API keys → Create key.
  2. Find your team ID: open Linear → click any team → look at the URL linear.app/<workspace>/team/<TEAM> → <TEAM> is the team key (e.g., APP). Or use the GraphQL explorer to call teams { id }.
  3. (Optional) Find a project ID: same way, from a project URL.
The integration is tested before saving — a viewer { id name } query is run with your key.

​
Enable

Linear actions only fire in write mode — read mode strips them entirely.

​
What gets created

When the agent proposes:
Linear receives:
  • Title — the action title
  • Description — markdown body with the rationale + a link back to the report
  • Priority — mapped from urgent / high / medium / low
  • Labels — applied if they exist on your team
  • Project — if projectId is set in config, the issue is filed there

​
Auto-approve

If you’re confident in the agent’s issue quality, add linear_issue to autoApproveTypes:
Issues will be created immediately without waiting for your review.