Skip to main content
Plugin ID: linear | Auth: OAuth2 (provider id linear) | Scopes: read, write Handlers call Linear’s GraphQL API at https://api.linear.app/graphql via a small linearGraphQL() helper. List uses an Issues($first, $filter) query (filter assembled from teamId / projectId when provided); create uses an IssueCreate($input) mutation and returns the issue’s id / identifier / url. The destructive create tool elicits user approval before submitting.

​
Tools

​
linear.issues.list

Name: List Issues List issues from Linear, optionally filtered by team or project.
ParameterTypeRequiredDefaultDescription
teamIdstringNo—Filter by team
projectIdstringNo—Filter by project
limitintegerNo25Max issues to return
Output: 
{
  "issues": [
    {
      "id": "issue-001",
      "identifier": "ENG-42",
      "title": "Fix authentication flow",
      "state": "In Progress",
      "url": "https://linear.app/team/issue/ENG-42"
    }
  ]
}

​
linear.issues.create

Name: Create Issue | Destructive: Yes Create a new issue in Linear. Requires user approval.
ParameterTypeRequiredDescription
teamIdstringYesTeam to create the issue in
titlestringYesIssue title
descriptionstringNoIssue description (markdown)
projectIdstringNoProject to associate with
priorityintegerNoPriority level (0-4)
Output: 
{
  "id": "issue-002",
  "identifier": "ENG-43",
  "url": "https://linear.app/team/issue/ENG-43"
}