Skip to main content

​
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. With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.
VariableRequiredDescription
LINEAR_CLIENT_IDYesLinear OAuth Client ID (from your OAuth application) Docs.
LINEAR_CLIENT_SECRETYesLinear OAuth Client Secret Docs.

​
Tools

ToolAccessDescription
Search IssuesReadSearch for Linear issues by title or description
Get IssueReadGet detailed information about a specific Linear issue
Create IssueWriteCreate a new Linear issue in a team
Update IssueWriteUpdate the status, assignee, or other properties of an issue
Delete IssueWriteArchive a Linear issue. By default this is non-permanent so canary-created issues do not remain active.
List ProjectsReadList all projects in the workspace
List TeamsReadList Linear teams in the workspace so issues can be created in the right team
List Workflow StatesReadList workflow states for a Linear team so issues can be moved to the right status
List UsersReadList Linear users in the workspace so issues can be assigned to the right person
Add CommentWriteAdd a comment to a Linear issue
List Issue LabelsReadList 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.