Linear

27 actions for managing issues, cycles, projects, and team workflow.

Issues

`create_issue`

Create a new Linear issue.

Parameter	Type	Required	Description
`teamId`	string	yes	Team to create the issue in
`title`	string	yes	Issue title
`description`	string	no	Markdown description
`priority`	number	no	0 (none) to 4 (urgent)
`assigneeId`	string	no	User to assign
`labelIds`	array	no	Label IDs to apply
`cycleId`	string	no	Cycle to add to
`projectId`	string	no	Project to add to

exec("linear.create_issue", {
  teamId: "TEAM_ID",
  title: "Fix authentication timeout",
  description: "Users report 30s timeout on login page",
  priority: 2
})

`update_issue`

Parameter	Type	Required	Description
`issueId`	string	yes	Issue to update
`title`	string	no	New title
`description`	string	no	New description
`priority`	number	no	New priority
`stateId`	string	no	New workflow state
`assigneeId`	string	no	New assignee
`labelIds`	array	no	New labels
`cycleId`	string	no	New cycle

`get_issue`

Get an issue by ID with all relations.

Parameter	Type	Required
`issueId`	string	yes

`batch_create_issues`

Create up to 50 issues at once. Each item has the same shape as create_issue.

Parameter	Type	Required
`issues`	array	yes

`archive_issue`

Parameter	Type	Required
`issueId`	string	yes

`assign_issue`

Parameter	Type	Required
`issueId`	string	yes
`assigneeId`	string	yes

`search`

Search issues by title and description.

Parameter	Type	Required
`query`	string	yes

Relations

`create_issue_relation`

Parameter	Type	Required	Description
`issueId`	string	yes	Source issue
`relatedIssueId`	string	yes	Target issue
`type`	string	yes	`blocks`, `blocked_by`, `related`, `duplicate`

`list_issue_relations`

Parameter	Type	Required
`issueId`	string	yes

Comments

`add_comment`

Parameter	Type	Required	Description
`issueId`	string	yes	Issue to comment on
`body`	string	yes	Markdown comment body

`list_comments`

Parameter	Type	Required
`issueId`	string	yes

Cycles (Sprints)

`get_active_cycle`

Parameter	Type	Required
`teamId`	string	yes

`list_cycles`

Parameter	Type	Required	Description
`teamId`	string	yes	Team to list cycles for
`first`	number	no	Number of cycles to return

`add_issue_to_cycle`

Parameter	Type	Required
`issueId`	string	yes
`cycleId`	string	yes

Initiatives

`list_initiatives`

No parameters. Returns all roadmap initiatives.

`get_initiative`

Parameter	Type	Required
`id`	string	yes

Attachments

`create_attachment`

Attach an external resource to an issue.

Parameter	Type	Required	Description
`issueId`	string	yes	Issue to attach to
`title`	string	yes	Attachment title
`url`	string	yes	External URL
`subtitle`	string	no	Subtitle text
`iconUrl`	string	no	Icon URL

Workspace

`list_teams`

List all teams and their members. No parameters.

`list_workflow_states`

Parameter	Type	Required
`teamId`	string	no

`list_labels`

No parameters. Returns all workspace labels.

`list_projects`

No parameters. Returns all projects.

`get_viewer`

No parameters. Returns the authenticated user.

`list_users`

No parameters. Returns all workspace members.

GraphQL

`graphql`

Run an arbitrary GraphQL query or mutation against the Linear API.

Parameter	Type	Required	Description
`query`	string	yes	GraphQL query string
`variables`	object	no	Query variables

exec("linear.graphql", {
  query: "query { viewer { id name email } }"
})