Linear

Usage Instructions

Integrate Linear into the workflow. Can manage issues, comments, projects, labels, workflow states, cycles, attachments, and more. Can also trigger workflows based on Linear webhook events.

Tools

`linear_read_issues`

Input

Parameter	Type	Required	Description
`teamId`	string	No	No description
`projectId`	string	No	No description
`assigneeId`	string	No	No description
`stateId`	string	No	No description
`priority`	number	No	No description
`labelIds`	array	No	No description
`createdAfter`	string	No	No description
`updatedAfter`	string	No	No description
`includeArchived`	boolean	No	No description
`first`	number	No	No description
`after`	string	No	No description
`orderBy`	string	No	Sort order: "createdAt" or "updatedAt" (default: "updatedAt")

Output

Parameter	Type	Description
`hasNextPage`	boolean	Whether there are more results
`endCursor`	string	Cursor for the next page
`issues`	array	Array of filtered issues from Linear
↳ `id`	string	Issue ID
↳ `title`	string	Issue title
↳ `description`	string	Issue description
↳ `priority`	number	Priority (0=No priority, 1=Urgent, 2=High, 3=Normal, 4=Low)
↳ `estimate`	number	Estimate in points
↳ `url`	string	Issue URL
↳ `dueDate`	string	Due date (YYYY-MM-DD)
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)
↳ `state`	object	Workflow state/status
↳ `id`	string	State ID
↳ `name`	string	State name (e.g., "Todo", "In Progress")
↳ `type`	string	State type (unstarted, started, completed, canceled)
↳ `assignee`	object	User object
↳ `id`	string	User ID
↳ `name`	string	User name
↳ `email`	string	User email
↳ `teamId`	string	Team ID
↳ `teamName`	string	Team name
↳ `projectId`	string	Project ID
↳ `projectName`	string	Project name
↳ `cycleId`	string	Cycle ID
↳ `cycleNumber`	number	Cycle number
↳ `cycleName`	string	Cycle name
↳ `labels`	array	Issue labels
↳ `id`	string	Label ID
↳ `name`	string	Label name
↳ `color`	string	Label color (hex)

`linear_get_issue`

Input

Parameter	Type	Required	Description
`issueId`	string	Yes	No description

Output

Parameter	Type	Description
`issue`	object	The issue with full details
↳ `id`	string	Issue ID
↳ `title`	string	Issue title
↳ `description`	string	Issue description
↳ `priority`	number	Priority (0=No priority, 1=Urgent, 2=High, 3=Normal, 4=Low)
↳ `estimate`	number	Estimate in points
↳ `url`	string	Issue URL
↳ `dueDate`	string	Due date (YYYY-MM-DD)
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)
↳ `completedAt`	string	Completion timestamp (ISO 8601)
↳ `canceledAt`	string	Cancellation timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)
↳ `state`	object	Workflow state/status
↳ `id`	string	State ID
↳ `name`	string	State name (e.g., "Todo", "In Progress")
↳ `type`	string	State type (unstarted, started, completed, canceled)
↳ `assignee`	object	User object
↳ `id`	string	User ID
↳ `name`	string	User name
↳ `email`	string	User email
↳ `teamId`	string	Team ID
↳ `projectId`	string	Project ID
↳ `labels`	array	Issue labels
↳ `id`	string	Label ID
↳ `name`	string	Label name
↳ `color`	string	Label color (hex)

`linear_create_issue`

Input

Parameter	Type	Required	Description
`teamId`	string	Yes	No description
`projectId`	string	No	No description
`title`	string	Yes	No description
`description`	string	No	No description
`stateId`	string	No	No description
`assigneeId`	string	No	No description
`priority`	number	No	No description
`estimate`	number	No	No description
`labelIds`	array	No	No description
`cycleId`	string	No	No description
`parentId`	string	No	No description
`dueDate`	string	No	No description
`subscriberIds`	array	No	No description
`projectMilestoneId`	string	No	No description

Output

Parameter	Type	Description
`issue`	object	The created issue with all its properties
↳ `id`	string	Issue ID
↳ `title`	string	Issue title
↳ `description`	string	Issue description
↳ `priority`	number	Priority (0=No priority, 1=Urgent, 2=High, 3=Normal, 4=Low)
↳ `estimate`	number	Estimate in points
↳ `url`	string	Issue URL
↳ `dueDate`	string	Due date (YYYY-MM-DD)
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)
↳ `completedAt`	string	Completion timestamp (ISO 8601)
↳ `canceledAt`	string	Cancellation timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)
↳ `state`	object	Workflow state/status
↳ `id`	string	State ID
↳ `name`	string	State name (e.g., "Todo", "In Progress")
↳ `type`	string	State type (unstarted, started, completed, canceled)
↳ `assignee`	object	User object
↳ `id`	string	User ID
↳ `name`	string	User name
↳ `email`	string	User email
↳ `teamId`	string	Team ID
↳ `projectId`	string	Project ID
↳ `labels`	array	Issue labels
↳ `id`	string	Label ID
↳ `name`	string	Label name
↳ `color`	string	Label color (hex)
↳ `cycleId`	string	Cycle ID
↳ `cycleNumber`	number	Cycle number
↳ `cycleName`	string	Cycle name
↳ `parentId`	string	Parent issue ID
↳ `parentTitle`	string	Parent issue title
↳ `projectMilestoneId`	string	Project milestone ID
↳ `projectMilestoneName`	string	Project milestone name

`linear_update_issue`

Input

Parameter	Type	Required	Description
`issueId`	string	Yes	No description
`title`	string	No	No description
`description`	string	No	No description
`stateId`	string	No	No description
`assigneeId`	string	No	No description
`priority`	number	No	No description
`estimate`	number	No	No description
`labelIds`	array	No	No description
`projectId`	string	No	No description
`cycleId`	string	No	No description
`parentId`	string	No	No description
`dueDate`	string	No	No description
`addedLabelIds`	array	No	No description
`removedLabelIds`	array	No	No description

Output

Parameter	Type	Description
`issue`	object	The updated issue
↳ `id`	string	Issue ID
↳ `title`	string	Issue title
↳ `description`	string	Issue description
↳ `priority`	number	Priority (0=No priority, 1=Urgent, 2=High, 3=Normal, 4=Low)
↳ `estimate`	number	Estimate in points
↳ `url`	string	Issue URL
↳ `dueDate`	string	Due date (YYYY-MM-DD)
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)
↳ `completedAt`	string	Completion timestamp (ISO 8601)
↳ `canceledAt`	string	Cancellation timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)
↳ `state`	object	Workflow state/status
↳ `id`	string	State ID
↳ `name`	string	State name (e.g., "Todo", "In Progress")
↳ `type`	string	State type (unstarted, started, completed, canceled)
↳ `assignee`	object	User object
↳ `id`	string	User ID
↳ `name`	string	User name
↳ `email`	string	User email
↳ `teamId`	string	Team ID
↳ `projectId`	string	Project ID
↳ `labels`	array	Issue labels
↳ `id`	string	Label ID
↳ `name`	string	Label name
↳ `color`	string	Label color (hex)
↳ `cycleId`	string	Cycle ID
↳ `cycleNumber`	number	Cycle number
↳ `cycleName`	string	Cycle name
↳ `parentId`	string	Parent issue ID
↳ `parentTitle`	string	Parent issue title
↳ `projectMilestoneId`	string	Project milestone ID
↳ `projectMilestoneName`	string	Project milestone name

`linear_archive_issue`

Input

Parameter	Type	Required	Description
`issueId`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the archive operation was successful
`issueId`	string	The ID of the archived issue

`linear_unarchive_issue`

Input

Parameter	Type	Required	Description
`issueId`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the unarchive operation was successful
`issueId`	string	The ID of the unarchived issue

`linear_delete_issue`

Input

Parameter	Type	Required	Description
`issueId`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the delete operation was successful

`linear_search_issues`

Input

Parameter	Type	Required	Description
`query`	string	Yes	No description
`teamId`	string	No	No description
`includeArchived`	boolean	No	No description
`first`	number	No	No description
`after`	string	No	No description

Output

Parameter	Type	Description
`pageInfo`	object	Pagination information
↳ `hasNextPage`	boolean	Whether there are more results
↳ `endCursor`	string	Cursor for the next page
`issues`	array	Array of matching issues
↳ `id`	string	Issue ID
↳ `title`	string	Issue title
↳ `description`	string	Issue description
↳ `priority`	number	Priority (0=No priority, 1=Urgent, 2=High, 3=Normal, 4=Low)
↳ `estimate`	number	Estimate in points
↳ `url`	string	Issue URL
↳ `dueDate`	string	Due date (YYYY-MM-DD)
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)
↳ `completedAt`	string	Completion timestamp (ISO 8601)
↳ `canceledAt`	string	Cancellation timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)
↳ `state`	object	Workflow state/status
↳ `id`	string	State ID
↳ `name`	string	State name (e.g., "Todo", "In Progress")
↳ `type`	string	State type (unstarted, started, completed, canceled)
↳ `assignee`	object	User object
↳ `id`	string	User ID
↳ `name`	string	User name
↳ `email`	string	User email
↳ `teamId`	string	Team ID
↳ `projectId`	string	Project ID
↳ `labels`	array	Issue labels
↳ `id`	string	Label ID
↳ `name`	string	Label name
↳ `color`	string	Label color (hex)

`linear_add_label_to_issue`

Input

Parameter	Type	Required	Description
`issueId`	string	Yes	No description
`labelId`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the label was successfully added
`issueId`	string	The ID of the issue

`linear_remove_label_from_issue`

Input

Parameter	Type	Required	Description
`issueId`	string	Yes	No description
`labelId`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the label was successfully removed
`issueId`	string	The ID of the issue

`linear_create_comment`

Input

Parameter	Type	Required	Description
`issueId`	string	Yes	No description
`body`	string	Yes	No description

Output

Parameter	Type	Description
`comment`	object	The created comment
↳ `id`	string	Comment ID
↳ `body`	string	Comment text (Markdown)
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)
↳ `user`	object	User object
↳ `id`	string	User ID
↳ `name`	string	User name
↳ `email`	string	User email
↳ `issue`	object	Issue object
↳ `id`	string	Issue ID
↳ `title`	string	Issue title

`linear_update_comment`

Input

Parameter	Type	Required	Description
`commentId`	string	Yes	No description
`body`	string	No	No description

Output

Parameter	Type	Description
`comment`	object	The updated comment
↳ `id`	string	Comment ID
↳ `body`	string	Comment text (Markdown)
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)
↳ `user`	object	User object
↳ `id`	string	User ID
↳ `name`	string	User name
↳ `email`	string	User email
↳ `issue`	object	Issue object
↳ `id`	string	Issue ID
↳ `title`	string	Issue title

`linear_delete_comment`

Input

Parameter	Type	Required	Description
`commentId`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the delete operation was successful

`linear_list_comments`

Input

Parameter	Type	Required	Description
`issueId`	string	Yes	No description
`first`	number	No	No description
`after`	string	No	No description

Output

Parameter	Type	Description
`pageInfo`	object	Pagination information
↳ `hasNextPage`	boolean	Whether there are more results
↳ `endCursor`	string	Cursor for the next page
`comments`	array	Array of comments on the issue
↳ `id`	string	Comment ID
↳ `body`	string	Comment text (Markdown)
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)
↳ `user`	object	User object
↳ `id`	string	User ID
↳ `name`	string	User name
↳ `email`	string	User email
↳ `issue`	object	Issue object
↳ `id`	string	Issue ID
↳ `title`	string	Issue title

`linear_list_projects`

Input

Parameter	Type	Required	Description
`teamId`	string	No	No description
`includeArchived`	boolean	No	No description
`first`	number	No	No description
`after`	string	No	No description

Output

Parameter	Type	Description
`pageInfo`	object	Pagination information
↳ `hasNextPage`	boolean	Whether there are more results
↳ `endCursor`	string	Cursor for the next page
`projects`	array	Array of projects
↳ `id`	string	Project ID
↳ `name`	string	Project name
↳ `description`	string	Project description
↳ `state`	string	Project state (planned, started, paused, completed, canceled)
↳ `priority`	number	Project priority (0-4)
↳ `startDate`	string	Start date (YYYY-MM-DD)
↳ `targetDate`	string	Target date (YYYY-MM-DD)
↳ `url`	string	Project URL
↳ `lead`	object	User object
↳ `id`	string	User ID
↳ `name`	string	User name
↳ `email`	string	User email
↳ `teams`	array	Associated teams
↳ `id`	string	Team ID
↳ `name`	string	Team name

`linear_get_project`

Input

Parameter	Type	Required	Description
`projectId`	string	Yes	No description

Output

Parameter	Type	Description
`project`	object	The project with full details
↳ `id`	string	Project ID
↳ `name`	string	Project name
↳ `description`	string	Project description
↳ `state`	string	Project state (planned, started, paused, completed, canceled)
↳ `priority`	number	Project priority (0-4)
↳ `startDate`	string	Start date (YYYY-MM-DD)
↳ `targetDate`	string	Target date (YYYY-MM-DD)
↳ `url`	string	Project URL
↳ `lead`	object	User object
↳ `id`	string	User ID
↳ `name`	string	User name
↳ `email`	string	User email
↳ `teams`	array	Associated teams
↳ `id`	string	Team ID
↳ `name`	string	Team name

`linear_create_project`

Input

Parameter	Type	Required	Description
`teamId`	string	Yes	No description
`name`	string	Yes	No description
`description`	string	No	No description
`leadId`	string	No	No description
`startDate`	string	No	No description
`targetDate`	string	No	No description
`priority`	number	No	No description

Output

Parameter	Type	Description
`project`	object	The created project
↳ `id`	string	Project ID
↳ `name`	string	Project name
↳ `description`	string	Project description
↳ `state`	string	Project state (planned, started, paused, completed, canceled)
↳ `priority`	number	Project priority (0-4)
↳ `startDate`	string	Start date (YYYY-MM-DD)
↳ `targetDate`	string	Target date (YYYY-MM-DD)
↳ `url`	string	Project URL
↳ `lead`	object	User object
↳ `id`	string	User ID
↳ `name`	string	User name
↳ `email`	string	User email
↳ `teams`	array	Associated teams
↳ `id`	string	Team ID
↳ `name`	string	Team name

`linear_update_project`

Input

Parameter	Type	Required	Description
`projectId`	string	Yes	No description
`name`	string	No	No description
`description`	string	No	No description
`state`	string	No	No description
`leadId`	string	No	No description
`startDate`	string	No	No description
`targetDate`	string	No	No description
`priority`	number	No	No description

Output

Parameter	Type	Description
`project`	object	The updated project
↳ `id`	string	Project ID
↳ `name`	string	Project name
↳ `description`	string	Project description
↳ `state`	string	Project state (planned, started, paused, completed, canceled)
↳ `priority`	number	Project priority (0-4)
↳ `startDate`	string	Start date (YYYY-MM-DD)
↳ `targetDate`	string	Target date (YYYY-MM-DD)
↳ `url`	string	Project URL
↳ `lead`	object	User object
↳ `id`	string	User ID
↳ `name`	string	User name
↳ `email`	string	User email
↳ `teams`	array	Associated teams
↳ `id`	string	Team ID
↳ `name`	string	Team name

`linear_archive_project`

Input

Parameter	Type	Required	Description
`projectId`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the archive operation was successful
`projectId`	string	The ID of the archived project

`linear_list_users`

Input

Parameter	Type	Required	Description
`includeDisabled`	boolean	No	No description
`first`	number	No	No description
`after`	string	No	No description

Output

Parameter	Type	Description
`pageInfo`	object	Pagination information
↳ `hasNextPage`	boolean	Whether there are more results
↳ `endCursor`	string	Cursor for the next page
`users`	array	Array of workspace users
↳ `id`	string	User ID
↳ `name`	string	User name
↳ `email`	string	User email
↳ `displayName`	string	Display name
↳ `active`	boolean	Whether user is active
↳ `admin`	boolean	Whether user is admin
↳ `avatarUrl`	string	Avatar URL

`linear_list_teams`

Input

Parameter	Type	Required	Description
`first`	number	No	No description
`after`	string	No	No description

Output

Parameter	Type	Description
`pageInfo`	object	Pagination information
↳ `hasNextPage`	boolean	Whether there are more results
↳ `endCursor`	string	Cursor for the next page
`teams`	array	Array of teams
↳ `id`	string	Team ID
↳ `name`	string	Team name
↳ `key`	string	Team key (used in issue identifiers)
↳ `description`	string	Team description

`linear_get_viewer`

Input

Parameter	Type	Required	Description

Output

Parameter	Type	Description
`user`	object	The currently authenticated user
↳ `id`	string	User ID
↳ `name`	string	User name
↳ `email`	string	User email
↳ `displayName`	string	Display name
↳ `active`	boolean	Whether user is active
↳ `admin`	boolean	Whether user is admin
↳ `avatarUrl`	string	Avatar URL

`linear_list_labels`

Input

Parameter	Type	Required	Description
`teamId`	string	No	No description
`first`	number	No	No description
`after`	string	No	No description

Output

Parameter	Type	Description
`pageInfo`	object	Pagination information
↳ `hasNextPage`	boolean	Whether there are more results
↳ `endCursor`	string	Cursor for the next page
`labels`	array	Array of labels
↳ `id`	string	Label ID
↳ `name`	string	Label name
↳ `color`	string	Label color (hex)
↳ `description`	string	Label description
↳ `isGroup`	boolean	Whether this label is a group
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)
↳ `team`	object	Team object
↳ `id`	string	Team ID
↳ `name`	string	Team name

`linear_create_label`

Input

Parameter	Type	Required	Description
`name`	string	Yes	No description
`color`	string	No	Label color (hex format, e.g., "#ff0000")
`description`	string	No	No description
`teamId`	string	No	No description

Output

Parameter	Type	Description
`label`	object	The created label
↳ `id`	string	Label ID
↳ `name`	string	Label name
↳ `color`	string	Label color (hex)
↳ `description`	string	Label description
↳ `isGroup`	boolean	Whether this label is a group
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)
↳ `team`	object	Team object
↳ `id`	string	Team ID
↳ `name`	string	Team name

`linear_update_label`

Input

Parameter	Type	Required	Description
`labelId`	string	Yes	No description
`name`	string	No	No description
`color`	string	No	No description
`description`	string	No	No description

Output

Parameter	Type	Description
`label`	object	The updated label
↳ `id`	string	Label ID
↳ `name`	string	Label name
↳ `color`	string	Label color (hex)
↳ `description`	string	Label description
↳ `isGroup`	boolean	Whether this label is a group
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)
↳ `team`	object	Team object
↳ `id`	string	Team ID
↳ `name`	string	Team name

`linear_archive_label`

Input

Parameter	Type	Required	Description
`labelId`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the archive operation was successful
`labelId`	string	The ID of the archived label

`linear_list_workflow_states`

Input

Parameter	Type	Required	Description
`teamId`	string	No	No description
`first`	number	No	No description
`after`	string	No	No description

Output

Parameter	Type	Description
`pageInfo`	object	Pagination information
↳ `hasNextPage`	boolean	Whether there are more results
↳ `endCursor`	string	Cursor for the next page
`states`	array	Array of workflow states
↳ `id`	string	State ID
↳ `name`	string	State name (e.g., "Todo", "In Progress")
↳ `description`	string	State description
↳ `type`	string	State type (triage, backlog, unstarted, started, completed, canceled)
↳ `color`	string	State color (hex)
↳ `position`	number	State position in workflow
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)
↳ `team`	object	Team object
↳ `id`	string	Team ID
↳ `name`	string	Team name

`linear_create_workflow_state`

Input

Parameter	Type	Required	Description
`teamId`	string	Yes	No description
`name`	string	Yes	State name (e.g., "In Review")
`color`	string	No	No description
`type`	string	Yes	State type: "backlog", "unstarted", "started", "completed", or "canceled"
`description`	string	No	No description
`position`	number	No	No description

Output

Parameter	Type	Description
`state`	object	The created workflow state
↳ `id`	string	State ID
↳ `name`	string	State name (e.g., "Todo", "In Progress")
↳ `description`	string	State description
↳ `type`	string	State type (triage, backlog, unstarted, started, completed, canceled)
↳ `color`	string	State color (hex)
↳ `position`	number	State position in workflow
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)
↳ `team`	object	Team object
↳ `id`	string	Team ID
↳ `name`	string	Team name

`linear_update_workflow_state`

Input

Parameter	Type	Required	Description
`stateId`	string	Yes	No description
`name`	string	No	No description
`color`	string	No	No description
`description`	string	No	No description
`position`	number	No	No description

Output

Parameter	Type	Description
`state`	object	The updated workflow state
↳ `id`	string	State ID
↳ `name`	string	State name (e.g., "Todo", "In Progress")
↳ `description`	string	State description
↳ `type`	string	State type (triage, backlog, unstarted, started, completed, canceled)
↳ `color`	string	State color (hex)
↳ `position`	number	State position in workflow
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)
↳ `team`	object	Team object
↳ `id`	string	Team ID
↳ `name`	string	Team name

`linear_list_cycles`

Input

Parameter	Type	Required	Description
`teamId`	string	No	No description
`first`	number	No	No description
`after`	string	No	No description

Output

Parameter	Type	Description
`pageInfo`	object	Pagination information
↳ `hasNextPage`	boolean	Whether there are more results
↳ `endCursor`	string	Cursor for the next page
`cycles`	array	Array of cycles
↳ `id`	string	Cycle ID
↳ `number`	number	Cycle number
↳ `name`	string	Cycle name
↳ `startsAt`	string	Start date (ISO 8601)
↳ `endsAt`	string	End date (ISO 8601)
↳ `completedAt`	string	Completion date (ISO 8601)
↳ `progress`	number	Progress percentage (0-1)
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `team`	object	Team object
↳ `id`	string	Team ID
↳ `name`	string	Team name

`linear_get_cycle`

Input

Parameter	Type	Required	Description
`cycleId`	string	Yes	No description

Output

Parameter	Type	Description
`cycle`	object	The cycle with full details
↳ `id`	string	Cycle ID
↳ `number`	number	Cycle number
↳ `name`	string	Cycle name
↳ `startsAt`	string	Start date (ISO 8601)
↳ `endsAt`	string	End date (ISO 8601)
↳ `completedAt`	string	Completion date (ISO 8601)
↳ `progress`	number	Progress percentage (0-1)
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `team`	object	Team object
↳ `id`	string	Team ID
↳ `name`	string	Team name

`linear_create_cycle`

Input

Parameter	Type	Required	Description
`teamId`	string	Yes	No description
`startsAt`	string	Yes	No description
`endsAt`	string	Yes	No description
`name`	string	No	No description

Output

Parameter	Type	Description
`cycle`	object	The created cycle
↳ `id`	string	Cycle ID
↳ `number`	number	Cycle number
↳ `name`	string	Cycle name
↳ `startsAt`	string	Start date (ISO 8601)
↳ `endsAt`	string	End date (ISO 8601)
↳ `completedAt`	string	Completion date (ISO 8601)
↳ `progress`	number	Progress percentage (0-1)
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `team`	object	Team object
↳ `id`	string	Team ID
↳ `name`	string	Team name

`linear_get_active_cycle`

Input

Parameter	Type	Required	Description
`teamId`	string	Yes	No description

Output

Parameter	Type	Description
`cycle`	object	The active cycle (null if no active cycle)
↳ `id`	string	Cycle ID
↳ `number`	number	Cycle number
↳ `name`	string	Cycle name
↳ `startsAt`	string	Start date (ISO 8601)
↳ `endsAt`	string	End date (ISO 8601)
↳ `completedAt`	string	Completion date (ISO 8601)
↳ `progress`	number	Progress percentage (0-1)
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `team`	object	Team object
↳ `id`	string	Team ID
↳ `name`	string	Team name

`linear_create_attachment`

Input

Parameter	Type	Required	Description
`issueId`	string	Yes	No description
`url`	string	No	No description
`file`	file	No	No description
`title`	string	Yes	No description
`subtitle`	string	No	No description

Output

Parameter	Type	Description
`attachment`	object	The created attachment
↳ `id`	string	Attachment ID
↳ `title`	string	Attachment title
↳ `subtitle`	string	Attachment subtitle
↳ `url`	string	Attachment URL
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)

`linear_list_attachments`

Input

Parameter	Type	Required	Description
`issueId`	string	Yes	No description
`first`	number	No	No description
`after`	string	No	No description

Output

Parameter	Type	Description
`pageInfo`	object	Pagination information
↳ `hasNextPage`	boolean	Whether there are more results
↳ `endCursor`	string	Cursor for the next page
`attachments`	array	Array of attachments
↳ `id`	string	Attachment ID
↳ `title`	string	Attachment title
↳ `subtitle`	string	Attachment subtitle
↳ `url`	string	Attachment URL
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)

`linear_update_attachment`

Input

Parameter	Type	Required	Description
`attachmentId`	string	Yes	No description
`title`	string	Yes	No description
`subtitle`	string	No	No description

Output

Parameter	Type	Description
`attachment`	object	The updated attachment
↳ `id`	string	Attachment ID
↳ `title`	string	Attachment title
↳ `subtitle`	string	Attachment subtitle
↳ `url`	string	Attachment URL
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)

`linear_delete_attachment`

Input

Parameter	Type	Required	Description
`attachmentId`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the delete operation was successful

`linear_create_issue_relation`

Input

Parameter	Type	Required	Description
`issueId`	string	Yes	No description
`relatedIssueId`	string	Yes	No description
`type`	string	Yes	Relation type: "blocks", "duplicate", or "related". Note: When creating "blocks" from A to B, the inverse relation (B blocked by A) is automatically created.

Output

Parameter	Type	Description
`relation`	object	The created issue relation
↳ `id`	string	Relation ID
↳ `type`	string	Relation type
↳ `issue`	object	Source issue
↳ `relatedIssue`	object	Target issue

`linear_list_issue_relations`

Input

Parameter	Type	Required	Description
`issueId`	string	Yes	No description
`first`	number	No	No description
`after`	string	No	No description

Output

Parameter	Type	Description
`relations`	array	Array of issue relations
↳ `id`	string	Relation ID
↳ `type`	string	Relation type
↳ `issue`	object	Source issue
↳ `relatedIssue`	object	Target issue
`pageInfo`	object	Pagination information

`linear_delete_issue_relation`

Input

Parameter	Type	Required	Description
`relationId`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the delete operation was successful

`linear_create_favorite`

Input

Parameter	Type	Required	Description
`issueId`	string	No	No description
`projectId`	string	No	No description
`cycleId`	string	No	No description
`labelId`	string	No	No description

Output

Parameter	Type	Description
`favorite`	object	The created favorite
↳ `id`	string	Favorite ID
↳ `type`	string	Favorite type
↳ `issue`	object	Favorited issue (if applicable)
↳ `project`	object	Favorited project (if applicable)
↳ `cycle`	object	Favorited cycle (if applicable)

`linear_list_favorites`

Input

Parameter	Type	Required	Description
`first`	number	No	No description
`after`	string	No	No description

Output

Parameter	Type	Description
`favorites`	array	Array of favorited items
↳ `id`	string	Favorite ID
↳ `type`	string	Favorite type
↳ `issue`	object	Favorited issue
↳ `project`	object	Favorited project
↳ `cycle`	object	Favorited cycle
`pageInfo`	object	Pagination information

`linear_create_project_update`

Input

Parameter	Type	Required	Description
`projectId`	string	Yes	No description
`body`	string	Yes	No description
`health`	string	No	Project health: "onTrack", "atRisk", or "offTrack"

Output

Parameter	Type	Description
`update`	object	The created project update
↳ `id`	string	Update ID
↳ `body`	string	Update message
↳ `health`	string	Project health status
↳ `createdAt`	string	Creation timestamp
↳ `user`	object	User who created the update

`linear_list_project_updates`

Input

Parameter	Type	Required	Description
`projectId`	string	Yes	No description
`first`	number	No	No description
`after`	string	No	No description

Output

Parameter	Type	Description
`updates`	array	Array of project updates
↳ `id`	string	Update ID
↳ `body`	string	Update message
↳ `health`	string	Project health
↳ `createdAt`	string	Creation timestamp
↳ `user`	object	User who created the update
`pageInfo`	object	Pagination information

`linear_list_notifications`

Input

Parameter	Type	Required	Description
`first`	number	No	No description
`after`	string	No	No description

Output

Parameter	Type	Description
`notifications`	array	Array of notifications
↳ `id`	string	Notification ID
↳ `type`	string	Notification type
↳ `createdAt`	string	Creation timestamp
↳ `readAt`	string	Read timestamp (null if unread)
↳ `issue`	object	Related issue
`pageInfo`	object	Pagination information

`linear_update_notification`

Input

Parameter	Type	Required	Description
`notificationId`	string	Yes	No description
`readAt`	string	No	No description

Output

Parameter	Type	Description
`notification`	object	The updated notification
↳ `id`	string	Notification ID
↳ `type`	string	Notification type
↳ `createdAt`	string	Creation timestamp
↳ `readAt`	string	Read timestamp
↳ `issue`	object	Related issue

`linear_create_customer`

Input

Parameter	Type	Required	Description
`name`	string	Yes	No description
`domains`	array	No	No description
`externalIds`	array	No	No description
`logoUrl`	string	No	Customer's logo URL
`ownerId`	string	No	No description
`revenue`	number	No	No description
`size`	number	No	No description
`statusId`	string	No	No description
`tierId`	string	No	No description

Output

Parameter	Type	Description
`customer`	object	The created customer
↳ `id`	string	Customer ID
↳ `name`	string	Customer name
↳ `domains`	array	Associated domains
↳ `externalIds`	array	External IDs from other systems
↳ `logoUrl`	string	Logo URL
↳ `slugId`	string	Unique URL slug
↳ `approximateNeedCount`	number	Number of customer needs
↳ `revenue`	number	Annual revenue
↳ `size`	number	Organization size
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)

`linear_list_customers`

Input

Parameter	Type	Required	Description
`first`	number	No	No description
`after`	string	No	No description
`includeArchived`	boolean	No	No description

Output

Parameter	Type	Description
`pageInfo`	object	Pagination information
↳ `hasNextPage`	boolean	Whether there are more results
↳ `endCursor`	string	Cursor for the next page
`customers`	array	Array of customers
↳ `id`	string	Customer ID
↳ `name`	string	Customer name
↳ `domains`	array	Associated domains
↳ `externalIds`	array	External IDs from other systems
↳ `logoUrl`	string	Logo URL
↳ `slugId`	string	Unique URL slug
↳ `approximateNeedCount`	number	Number of customer needs
↳ `revenue`	number	Annual revenue
↳ `size`	number	Organization size
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)

`linear_create_customer_request`

Create a customer request (need) in Linear. Assign to customer, set urgency (priority: 0 = Not important, 1 = Important), and optionally link to an issue.

Input

Parameter	Type	Required	Description
`customerId`	string	Yes	No description
`body`	string	No	No description
`priority`	number	No	No description
`issueId`	string	No	No description
`projectId`	string	No	No description

Output

Parameter	Type	Description
`customerNeed`	object	The created customer request
↳ `id`	string	Customer request ID
↳ `body`	string	Request description
↳ `priority`	number	Urgency level (0 = Not important, 1 = Important)
↳ `createdAt`	string	Creation timestamp
↳ `updatedAt`	string	Last update timestamp
↳ `archivedAt`	string	Archive timestamp (null if not archived)
↳ `customer`	object	Assigned customer
↳ `issue`	object	Linked issue (null if not linked)
↳ `project`	object	Linked project (null if not linked)
↳ `creator`	object	User who created the request
↳ `url`	string	URL to the customer request

`linear_update_customer_request`

Update a customer request (need) in Linear. Can change urgency, description, customer assignment, and linked issue.

Input

Parameter	Type	Required	Description
`customerNeedId`	string	Yes	No description
`body`	string	No	No description
`priority`	number	No	No description
`customerId`	string	No	No description
`issueId`	string	No	No description
`projectId`	string	No	No description

Output

Parameter	Type	Description
`customerNeed`	object	The updated customer request
↳ `id`	string	Customer request ID
↳ `body`	string	Request description
↳ `priority`	number	Urgency level (0 = Not important, 1 = Important)
↳ `createdAt`	string	Creation timestamp
↳ `updatedAt`	string	Last update timestamp
↳ `archivedAt`	string	Archive timestamp (null if not archived)
↳ `customer`	object	Assigned customer
↳ `issue`	object	Linked issue (null if not linked)
↳ `project`	object	Linked project (null if not linked)
↳ `creator`	object	User who created the request
↳ `url`	string	URL to the customer request

`linear_list_customer_requests`

Input

Parameter	Type	Required	Description
`first`	number	No	No description
`after`	string	No	No description
`includeArchived`	boolean	No	No description

Output

Parameter	Type	Description
`customerNeeds`	array	Array of customer requests
↳ `id`	string	Customer request ID
↳ `body`	string	Request description
↳ `priority`	number	Urgency level (0 = Not important, 1 = Important)
↳ `createdAt`	string	Creation timestamp
↳ `updatedAt`	string	Last update timestamp
↳ `archivedAt`	string	Archive timestamp (null if not archived)
↳ `customer`	object	Assigned customer
↳ `issue`	object	Linked issue (null if not linked)
↳ `project`	object	Linked project (null if not linked)
↳ `creator`	object	User who created the request
↳ `url`	string	URL to the customer request
`pageInfo`	object	Pagination information

`linear_get_customer`

Input

Parameter	Type	Required	Description
`customerId`	string	Yes	No description

Output

Parameter	Type	Description
`customer`	object	The customer data
↳ `id`	string	Customer ID
↳ `name`	string	Customer name
↳ `domains`	array	Associated domains
↳ `externalIds`	array	External IDs from other systems
↳ `logoUrl`	string	Logo URL
↳ `slugId`	string	Unique URL slug
↳ `approximateNeedCount`	number	Number of customer needs
↳ `revenue`	number	Annual revenue
↳ `size`	number	Organization size
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)

`linear_update_customer`

Input

Parameter	Type	Required	Description
`customerId`	string	Yes	No description
`name`	string	No	No description
`domains`	array	No	No description
`externalIds`	array	No	No description
`logoUrl`	string	No	No description
`ownerId`	string	No	No description
`revenue`	number	No	No description
`size`	number	No	No description
`statusId`	string	No	No description
`tierId`	string	No	No description

Output

Parameter	Type	Description
`customer`	object	The updated customer
↳ `id`	string	Customer ID
↳ `name`	string	Customer name
↳ `domains`	array	Associated domains
↳ `externalIds`	array	External IDs from other systems
↳ `logoUrl`	string	Logo URL
↳ `slugId`	string	Unique URL slug
↳ `approximateNeedCount`	number	Number of customer needs
↳ `revenue`	number	Annual revenue
↳ `size`	number	Organization size
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)

`linear_delete_customer`

Input

Parameter	Type	Required	Description
`customerId`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the deletion was successful

`linear_merge_customers`

Input

Parameter	Type	Required	Description
`sourceCustomerId`	string	Yes	No description
`targetCustomerId`	string	Yes	No description

Output

Parameter	Type	Description
`customer`	object	The merged target customer

`linear_create_customer_status`

Input

Parameter	Type	Required	Description
`name`	string	Yes	No description
`color`	string	Yes	No description
`description`	string	No	No description
`displayName`	string	No	No description
`position`	number	No	No description

Output

Parameter	Type	Description
`customerStatus`	object	The created customer status
↳ `id`	string	Customer status ID
↳ `name`	string	Status name
↳ `description`	string	Status description
↳ `color`	string	Status color (hex)
↳ `position`	number	Position in list
↳ `type`	string	Status type (active, inactive)
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last updated timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)

`linear_update_customer_status`

Input

Parameter	Type	Required	Description
`statusId`	string	Yes	No description
`name`	string	No	No description
`color`	string	No	No description
`description`	string	No	No description
`displayName`	string	No	No description
`position`	number	No	No description

Output

Parameter	Type	Description
`customerStatus`	object	The updated customer status
↳ `id`	string	Customer status ID
↳ `name`	string	Status name
↳ `description`	string	Status description
↳ `color`	string	Status color (hex)
↳ `position`	number	Position in list
↳ `type`	string	Status type (active, inactive)
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last updated timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)

`linear_delete_customer_status`

Input

Parameter	Type	Required	Description
`statusId`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the deletion was successful

`linear_list_customer_statuses`

Input

Parameter	Type	Required	Description
`first`	number	No	No description
`after`	string	No	No description

Output

Parameter	Type	Description
`pageInfo`	object	Pagination information
↳ `hasNextPage`	boolean	Whether there are more results
↳ `endCursor`	string	Cursor for the next page
`customerStatuses`	array	List of customer statuses
↳ `id`	string	Customer status ID
↳ `name`	string	Status name
↳ `description`	string	Status description
↳ `color`	string	Status color (hex)
↳ `position`	number	Position in list
↳ `type`	string	Status type (active, inactive)
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last updated timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)

`linear_create_customer_tier`

Input

Parameter	Type	Required	Description
`name`	string	Yes	No description
`color`	string	Yes	No description
`displayName`	string	No	No description
`description`	string	No	No description
`position`	number	No	No description

Output

Parameter	Type	Description
`customerTier`	object	The created customer tier
↳ `id`	string	Customer tier ID
↳ `name`	string	Tier name
↳ `displayName`	string	Display name
↳ `description`	string	Tier description
↳ `color`	string	Tier color (hex)
↳ `position`	number	Position in list
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)

`linear_update_customer_tier`

Input

Parameter	Type	Required	Description
`tierId`	string	Yes	No description
`name`	string	No	No description
`color`	string	No	No description
`displayName`	string	No	No description
`description`	string	No	No description
`position`	number	No	No description

Output

Parameter	Type	Description
`customerTier`	object	The updated customer tier

`linear_delete_customer_tier`

Input

Parameter	Type	Required	Description
`tierId`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the deletion was successful

`linear_list_customer_tiers`

Input

Parameter	Type	Required	Description
`first`	number	No	No description
`after`	string	No	No description

Output

Parameter	Type	Description
`pageInfo`	object	Pagination information
↳ `hasNextPage`	boolean	Whether there are more results
↳ `endCursor`	string	Cursor for the next page
`customerTiers`	array	List of customer tiers
↳ `id`	string	Customer tier ID
↳ `name`	string	Tier name
↳ `displayName`	string	Display name
↳ `description`	string	Tier description
↳ `color`	string	Tier color (hex)
↳ `position`	number	Position in list
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)

`linear_delete_project`

Input

Parameter	Type	Required	Description
`projectId`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the deletion was successful

`linear_create_project_label`

Input

Parameter	Type	Required	Description
`name`	string	Yes	No description
`color`	string	No	No description
`description`	string	No	No description
`isGroup`	boolean	No	No description
`parentId`	string	No	No description

Output

Parameter	Type	Description
`projectLabel`	object	The created project label
↳ `id`	string	Project label ID
↳ `name`	string	Label name
↳ `description`	string	Label description
↳ `color`	string	Label color (hex)
↳ `isGroup`	boolean	Whether this label is a group
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)

`linear_update_project_label`

Input

Parameter	Type	Required	Description
`labelId`	string	Yes	No description
`name`	string	No	No description
`color`	string	No	No description
`description`	string	No	No description

Output

Parameter	Type	Description
`projectLabel`	object	The updated project label
↳ `id`	string	Project label ID
↳ `name`	string	Label name
↳ `description`	string	Label description
↳ `color`	string	Label color (hex)
↳ `isGroup`	boolean	Whether this label is a group
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)

`linear_delete_project_label`

Input

Parameter	Type	Required	Description
`labelId`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the deletion was successful

`linear_list_project_labels`

Input

Parameter	Type	Required	Description
`projectId`	string	No	No description
`first`	number	No	No description
`after`	string	No	No description

Output

Parameter	Type	Description
`pageInfo`	object	Pagination information
↳ `hasNextPage`	boolean	Whether there are more results
↳ `endCursor`	string	Cursor for the next page
`projectLabels`	array	List of project labels
↳ `id`	string	Project label ID
↳ `name`	string	Label name
↳ `description`	string	Label description
↳ `color`	string	Label color (hex)
↳ `isGroup`	boolean	Whether this label is a group
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)

`linear_add_label_to_project`

Input

Parameter	Type	Required	Description
`projectId`	string	Yes	No description
`labelId`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the label was added successfully
`projectId`	string	The project ID

`linear_remove_label_from_project`

Input

Parameter	Type	Required	Description
`projectId`	string	Yes	No description
`labelId`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the label was removed successfully
`projectId`	string	The project ID

`linear_create_project_milestone`

Input

Parameter	Type	Required	Description
`projectId`	string	Yes	No description
`name`	string	Yes	No description
`description`	string	No	No description
`targetDate`	string	No	No description

Output

Parameter	Type	Description
`projectMilestone`	object	The created project milestone
↳ `id`	string	Project milestone ID
↳ `name`	string	Milestone name
↳ `description`	string	Milestone description
↳ `projectId`	string	Project ID
↳ `targetDate`	string	Target date (YYYY-MM-DD)
↳ `progress`	number	Progress percentage (0-1)
↳ `sortOrder`	number	Sort order within the project
↳ `status`	string	Milestone status (done, next, overdue, unstarted)
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)

`linear_update_project_milestone`

Input

Parameter	Type	Required	Description
`milestoneId`	string	Yes	No description
`name`	string	No	No description
`description`	string	No	No description
`targetDate`	string	No	No description

Output

Parameter	Type	Description
`projectMilestone`	object	The updated project milestone
↳ `id`	string	Project milestone ID
↳ `name`	string	Milestone name
↳ `description`	string	Milestone description
↳ `projectId`	string	Project ID
↳ `targetDate`	string	Target date (YYYY-MM-DD)
↳ `progress`	number	Progress percentage (0-1)
↳ `sortOrder`	number	Sort order within the project
↳ `status`	string	Milestone status (done, next, overdue, unstarted)
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)

`linear_delete_project_milestone`

Input

Parameter	Type	Required	Description
`milestoneId`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the deletion was successful

`linear_list_project_milestones`

Input

Parameter	Type	Required	Description
`projectId`	string	Yes	No description
`first`	number	No	No description
`after`	string	No	No description

Output

Parameter	Type	Description
`pageInfo`	object	Pagination information
↳ `hasNextPage`	boolean	Whether there are more results
↳ `endCursor`	string	Cursor for the next page
`projectMilestones`	array	List of project milestones
↳ `id`	string	Project milestone ID
↳ `name`	string	Milestone name
↳ `description`	string	Milestone description
↳ `projectId`	string	Project ID
↳ `targetDate`	string	Target date (YYYY-MM-DD)
↳ `progress`	number	Progress percentage (0-1)
↳ `sortOrder`	number	Sort order within the project
↳ `status`	string	Milestone status (done, next, overdue, unstarted)
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)

`linear_create_project_status`

Input

Parameter	Type	Required	Description
`name`	string	Yes	No description
`type`	string	Yes	Status type: "backlog", "planned", "started", "paused", "completed", or "canceled"
`color`	string	Yes	No description
`position`	number	Yes	No description
`description`	string	No	No description
`indefinite`	boolean	No	No description

Output

Parameter	Type	Description
`projectStatus`	object	The created project status
↳ `id`	string	Project status ID
↳ `name`	string	Status name
↳ `description`	string	Status description
↳ `color`	string	Status color (hex)
↳ `indefinite`	boolean	Whether this status is indefinite
↳ `position`	number	Position in list
↳ `type`	string	Status type (backlog, planned, started, paused, completed, canceled)
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last updated timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)

`linear_update_project_status`

Input

Parameter	Type	Required	Description
`statusId`	string	Yes	No description
`name`	string	No	No description
`color`	string	No	No description
`description`	string	No	No description
`indefinite`	boolean	No	No description
`position`	number	No	No description

Output

Parameter	Type	Description
`projectStatus`	object	The updated project status
↳ `id`	string	Project status ID
↳ `name`	string	Status name
↳ `description`	string	Status description
↳ `color`	string	Status color (hex)
↳ `indefinite`	boolean	Whether this status is indefinite
↳ `position`	number	Position in list
↳ `type`	string	Status type (backlog, planned, started, paused, completed, canceled)
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last updated timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)

`linear_delete_project_status`

Input

Parameter	Type	Required	Description
`statusId`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the deletion was successful

`linear_list_project_statuses`

Input

Parameter	Type	Required	Description
`first`	number	No	No description
`after`	string	No	No description

Output

Parameter	Type	Description
`pageInfo`	object	Pagination information
↳ `hasNextPage`	boolean	Whether there are more results
↳ `endCursor`	string	Cursor for the next page
`projectStatuses`	array	List of project statuses
↳ `id`	string	Project status ID
↳ `name`	string	Status name
↳ `description`	string	Status description
↳ `color`	string	Status color (hex)
↳ `indefinite`	boolean	Whether this status is indefinite
↳ `position`	number	Position in list
↳ `type`	string	Status type (backlog, planned, started, paused, completed, canceled)
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last updated timestamp (ISO 8601)
↳ `archivedAt`	string	Archive timestamp (ISO 8601)