Linear MCP Server

Instructions

Implementation Reference

• src/tools/handlers/issue-handlers.ts:84-97 (handler)

  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; } }; }
• src/tools/definitions/issue-tools.ts:271-361 (schema)

  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") ); }
• src/services/linear-service.ts:505-554 (helper)

  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'); } }