linear_updateIssue
Modify existing Linear issues by updating titles, descriptions, priorities, assignees, due dates, labels, and other project management fields to reflect current status and requirements.
Instructions
Update an existing issue in Linear
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ID or identifier of the issue to update (e.g., ABC-123) | |
| title | No | New title for the issue | |
| description | No | New description for the issue (Markdown supported) | |
| stateId | No | ID of the new state for the issue | |
| priority | No | New priority for the issue (0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low) | |
| projectId | No | ID of the project to move the issue to | |
| assigneeId | No | ID of the user to assign the issue to, or null to unassign | |
| cycleId | No | ID of the cycle to move the issue to, or null to remove from current cycle | |
| estimate | No | The estimated complexity/points for the issue | |
| dueDate | No | The new due date for the issue (YYYY-MM-DD format), or null to remove | |
| labelIds | No | IDs of the labels to set on the issue (replacing existing labels) | |
| addedLabelIds | No | IDs of labels to add to the issue (without removing existing ones) | |
| removedLabelIds | No | IDs of labels to remove from the issue | |
| parentId | No | ID of the parent issue, or null to convert to a regular issue | |
| subscriberIds | No | IDs of the users to subscribe to the issue (replacing existing subscribers) | |
| teamId | No | ID of the team to move the issue to | |
| sortOrder | No | The position of the issue in relation to other issues |
Implementation Reference
- The main handler function for the linear_updateIssue tool. It validates the input arguments using the type guard and delegates the update logic to the LinearService.
export function handleUpdateIssue(linearService: LinearService) { return async (args: unknown) => { try { if (!isUpdateIssueArgs(args)) { throw new Error("Invalid arguments for updateIssue"); } return await linearService.updateIssue(args); } catch (error) { logError("Error updating issue", error); throw error; } }; } - The MCP tool schema definition for linear_updateIssue, including input and output schemas.
export const updateIssueToolDefinition: MCPToolDefinition = { name: "linear_updateIssue", description: "Update an existing issue in Linear", input_schema: { type: "object", properties: { id: { type: "string", description: "ID or identifier of the issue to update (e.g., ABC-123)", }, title: { type: "string", description: "New title for the issue", }, description: { type: "string", description: "New description for the issue (Markdown supported)", }, stateId: { type: "string", description: "ID of the new state for the issue", }, priority: { type: "number", description: "New priority for the issue (0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low)", }, projectId: { type: "string", description: "ID of the project to move the issue to", }, assigneeId: { type: "string", description: "ID of the user to assign the issue to, or null to unassign", }, cycleId: { type: "string", description: "ID of the cycle to move the issue to, or null to remove from current cycle", }, estimate: { type: "number", description: "The estimated complexity/points for the issue", }, dueDate: { type: "string", description: "The new due date for the issue (YYYY-MM-DD format), or null to remove", }, labelIds: { type: "array", items: { type: "string" }, description: "IDs of the labels to set on the issue (replacing existing labels)", }, addedLabelIds: { type: "array", items: { type: "string" }, description: "IDs of labels to add to the issue (without removing existing ones)", }, removedLabelIds: { type: "array", items: { type: "string" }, description: "IDs of labels to remove from the issue", }, parentId: { type: "string", description: "ID of the parent issue, or null to convert to a regular issue", }, subscriberIds: { type: "array", items: { type: "string" }, description: "IDs of the users to subscribe to the issue (replacing existing subscribers)", }, teamId: { type: "string", description: "ID of the team to move the issue to", }, sortOrder: { type: "number", description: "The position of the issue in relation to other issues", }, }, required: ["id"], }, output_schema: { type: "object", properties: { id: { type: "string" }, identifier: { type: "string" }, title: { type: "string" }, url: { type: "string" } } } }; - src/tools/handlers/index.ts:51-100 (registration)The registration of the linear_updateIssue handler in the tool handlers map, mapping the tool name to the handleUpdateIssue function.
export function registerToolHandlers(linearService: LinearService) { return { // User tools linear_getViewer: handleGetViewer(linearService), linear_getOrganization: handleGetOrganization(linearService), linear_getUsers: handleGetUsers(linearService), linear_getLabels: handleGetLabels(linearService), // Team tools linear_getTeams: handleGetTeams(linearService), linear_getWorkflowStates: handleGetWorkflowStates(linearService), // Project tools linear_getProjects: handleGetProjects(linearService), linear_createProject: handleCreateProject(linearService), // Project Management tools linear_updateProject: handleUpdateProject(linearService), linear_addIssueToProject: handleAddIssueToProject(linearService), linear_getProjectIssues: handleGetProjectIssues(linearService), // Cycle Management tools linear_getCycles: handleGetCycles(linearService), linear_getActiveCycle: handleGetActiveCycle(linearService), linear_addIssueToCycle: handleAddIssueToCycle(linearService), // Issue tools linear_getIssues: handleGetIssues(linearService), linear_getIssueById: handleGetIssueById(linearService), linear_searchIssues: handleSearchIssues(linearService), linear_createIssue: handleCreateIssue(linearService), linear_updateIssue: handleUpdateIssue(linearService), linear_createComment: handleCreateComment(linearService), linear_addIssueLabel: handleAddIssueLabel(linearService), linear_removeIssueLabel: handleRemoveIssueLabel(linearService), // New Issue Management tools linear_assignIssue: handleAssignIssue(linearService), linear_subscribeToIssue: handleSubscribeToIssue(linearService), linear_convertIssueToSubtask: handleConvertIssueToSubtask(linearService), linear_createIssueRelation: handleCreateIssueRelation(linearService), linear_archiveIssue: handleArchiveIssue(linearService), linear_setIssuePriority: handleSetIssuePriority(linearService), linear_transferIssue: handleTransferIssue(linearService), linear_duplicateIssue: handleDuplicateIssue(linearService), linear_getIssueHistory: handleGetIssueHistory(linearService), // Comment Management tools linear_getComments: handleGetComments(linearService) }; - src/tools/type-guards.ts:134-177 (schema)Type guard function for validating arguments to the linear_updateIssue tool.
* Type guard for linear_updateIssue tool arguments */ export function isUpdateIssueArgs(args: unknown): args is { id: string; title?: string; description?: string; stateId?: string; priority?: number; projectId?: string; assigneeId?: string; cycleId?: string; estimate?: number; dueDate?: string; labelIds?: string[]; addedLabelIds?: string[]; removedLabelIds?: string[]; parentId?: string; subscriberIds?: string[]; teamId?: string; sortOrder?: number; } { return ( typeof args === "object" && args !== null && "id" in args && typeof (args as { id: string }).id === "string" && (!("title" in args) || typeof (args as { title: string }).title === "string") && (!("description" in args) || typeof (args as { description: string }).description === "string") && (!("stateId" in args) || typeof (args as { stateId: string }).stateId === "string") && (!("priority" in args) || typeof (args as { priority: number }).priority === "number") && (!("projectId" in args) || typeof (args as { projectId: string }).projectId === "string") && (!("assigneeId" in args) || typeof (args as { assigneeId: string }).assigneeId === "string") && (!("cycleId" in args) || typeof (args as { cycleId: string }).cycleId === "string") && (!("estimate" in args) || typeof (args as { estimate: number }).estimate === "number") && (!("dueDate" in args) || typeof (args as { dueDate: string }).dueDate === "string") && (!("labelIds" in args) || Array.isArray((args as { labelIds: string[] }).labelIds)) && (!("addedLabelIds" in args) || Array.isArray((args as { addedLabelIds: string[] }).addedLabelIds)) && (!("removedLabelIds" in args) || Array.isArray((args as { removedLabelIds: string[] }).removedLabelIds)) && (!("parentId" in args) || typeof (args as { parentId: string }).parentId === "string") && (!("subscriberIds" in args) || Array.isArray((args as { subscriberIds: string[] }).subscriberIds)) && (!("teamId" in args) || typeof (args as { teamId: string }).teamId === "string") && (!("sortOrder" in args) || typeof (args as { sortOrder: number }).sortOrder === "number") ); } - The LinearService method that performs the actual API call to update the issue using the Linear SDK.
async updateIssue(args: { id: string; title?: string; description?: string; stateId?: string; priority?: number; projectId?: string; assigneeId?: string; cycleId?: string; estimate?: number; dueDate?: string; labelIds?: string[]; addedLabelIds?: string[]; removedLabelIds?: string[]; parentId?: string; subscriberIds?: string[]; teamId?: string; sortOrder?: number; }) { const updatedIssue = await this.client.updateIssue(args.id, { title: args.title, description: args.description, stateId: args.stateId, priority: args.priority, projectId: args.projectId, assigneeId: args.assigneeId, cycleId: args.cycleId, estimate: args.estimate, dueDate: args.dueDate, labelIds: args.labelIds, addedLabelIds: args.addedLabelIds, removedLabelIds: args.removedLabelIds, parentId: args.parentId, subscriberIds: args.subscriberIds, teamId: args.teamId, sortOrder: args.sortOrder, }); if (updatedIssue.success && updatedIssue.issue) { const issueData = await updatedIssue.issue; return { id: issueData.id, title: issueData.title, description: issueData.description, url: issueData.url, }; } else { throw new Error('Failed to update issue'); } }