Linear MCP Server

import { MCPToolDefinition } from "../../types.js"; /** * Tool definition for getting issues */ export const getIssuesToolDefinition: MCPToolDefinition = { name: "linear_getIssues", description: "Get a list of recent issues from Linear", input_schema: { type: "object", properties: { limit: { type: "number", description: "Maximum number of issues to return (default: 10)", }, } }, output_schema: { type: "array", items: { type: "object", properties: { id: { type: "string" }, identifier: { type: "string" }, title: { type: "string" }, description: { type: "string" }, state: { type: "string" }, priority: { type: "number" }, estimate: { type: "number" }, dueDate: { type: "string" }, team: { type: "object" }, assignee: { type: "object" }, project: { type: "object" }, cycle: { type: "object" }, parent: { type: "object" }, labels: { type: "array", items: { type: "object", properties: { id: { type: "string" }, name: { type: "string" }, color: { type: "string" } } } }, sortOrder: { type: "number" }, createdAt: { type: "string" }, updatedAt: { type: "string" }, url: { type: "string" } } } } }; /** * Tool definition for getting issue by ID */ export const getIssueByIdToolDefinition: MCPToolDefinition = { name: "linear_getIssueById", description: "Get a specific issue by ID or identifier (e.g., ABC-123)", input_schema: { type: "object", properties: { id: { type: "string", description: "The ID or identifier of the issue (e.g., ABC-123)", }, }, required: ["id"], }, output_schema: { type: "object", properties: { id: { type: "string" }, identifier: { type: "string" }, title: { type: "string" }, description: { type: "string" }, state: { type: "string" }, priority: { type: "number" }, estimate: { type: "number" }, dueDate: { type: "string" }, team: { type: "object" }, assignee: { type: "object" }, project: { type: "object" }, cycle: { type: "object" }, parent: { type: "object" }, labels: { type: "array", items: { type: "object", properties: { id: { type: "string" }, name: { type: "string" }, color: { type: "string" } } } }, sortOrder: { type: "number" }, createdAt: { type: "string" }, updatedAt: { type: "string" }, url: { type: "string" }, comments: { type: "array" } } } }; /** * Tool definition for searching issues */ export const searchIssuesToolDefinition: MCPToolDefinition = { name: "linear_searchIssues", description: "Search for issues with various filters", input_schema: { type: "object", properties: { query: { type: "string", description: "Text to search for in issue title or description", }, teamId: { type: "string", description: "Filter issues by team ID", }, assigneeId: { type: "string", description: "Filter issues by assignee ID", }, projectId: { type: "string", description: "Filter issues by project ID", }, states: { type: "array", items: { type: "string" }, description: "Filter issues by state name (e.g., 'Todo', 'In Progress', 'Done')", }, limit: { type: "number", description: "Maximum number of issues to return (default: 10)", }, }, required: [], }, output_schema: { type: "array", items: { type: "object", properties: { id: { type: "string" }, identifier: { type: "string" }, title: { type: "string" }, description: { type: "string" }, state: { type: "string" }, priority: { type: "number" }, estimate: { type: "number" }, dueDate: { type: "string" }, team: { type: "object" }, assignee: { type: "object" }, project: { type: "object" }, cycle: { type: "object" }, parent: { type: "object" }, labels: { type: "array", items: { type: "object", properties: { id: { type: "string" }, name: { type: "string" }, color: { type: "string" } } } }, sortOrder: { type: "number" }, createdAt: { type: "string" }, updatedAt: { type: "string" }, url: { type: "string" } } } } }; /** * Tool definition for creating an issue */ export const createIssueToolDefinition: MCPToolDefinition = { name: "linear_createIssue", description: "Create a new issue in Linear", input_schema: { type: "object", properties: { title: { type: "string", description: "Title of the issue", }, description: { type: "string", description: "Description of the issue (Markdown supported)", }, teamId: { type: "string", description: "ID of the team the issue belongs to", }, assigneeId: { type: "string", description: "ID of the user to assign the issue to", }, priority: { type: "number", description: "Priority of the issue (0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low)", }, projectId: { type: "string", description: "ID of the project the issue belongs to", }, cycleId: { type: "string", description: "ID of the cycle to add the issue to", }, estimate: { type: "number", description: "The estimated complexity/points for the issue", }, dueDate: { type: "string", description: "The date at which the issue is due (YYYY-MM-DD format)", }, labelIds: { type: "array", items: { type: "string" }, description: "IDs of the labels to attach to the issue", }, parentId: { type: "string", description: "ID of the parent issue (to create as a sub-task)", }, subscriberIds: { type: "array", items: { type: "string" }, description: "IDs of the users to subscribe to the issue", }, stateId: { type: "string", description: "ID of the workflow state for the issue", }, templateId: { type: "string", description: "ID of a template to use for creating the issue", }, sortOrder: { type: "number", description: "The position of the issue in relation to other issues", }, }, required: ["title", "teamId"], }, output_schema: { type: "object", properties: { id: { type: "string" }, identifier: { type: "string" }, title: { type: "string" }, url: { type: "string" } } } }; /** * Tool definition for updating an issue */ 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" } } } }; /** * Tool definition for creating a comment */ export const createCommentToolDefinition: MCPToolDefinition = { name: "linear_createComment", description: "Add a comment to an issue in Linear", input_schema: { type: "object", properties: { issueId: { type: "string", description: "ID or identifier of the issue to comment on (e.g., ABC-123)", }, body: { type: "string", description: "Text of the comment (Markdown supported)", }, }, required: ["issueId", "body"], }, output_schema: { type: "object", properties: { id: { type: "string" }, body: { type: "string" }, url: { type: "string" } } } }; /** * Tool definition for adding a label to an issue */ export const addIssueLabelToolDefinition: MCPToolDefinition = { name: "linear_addIssueLabel", description: "Add a label to an issue in Linear", input_schema: { type: "object", properties: { issueId: { type: "string", description: "ID or identifier of the issue to add the label to (e.g., ABC-123)", }, labelId: { type: "string", description: "ID of the label to add to the issue", }, }, required: ["issueId", "labelId"], }, output_schema: { type: "object", properties: { success: { type: "boolean" }, issueId: { type: "string" }, labelId: { type: "string" } } } }; /** * Tool definition for removing a label from an issue */ export const removeIssueLabelToolDefinition: MCPToolDefinition = { name: "linear_removeIssueLabel", description: "Remove a label from an issue in Linear", input_schema: { type: "object", properties: { issueId: { type: "string", description: "ID or identifier of the issue to remove the label from (e.g., ABC-123)", }, labelId: { type: "string", description: "ID of the label to remove from the issue", }, }, required: ["issueId", "labelId"], }, output_schema: { type: "object", properties: { success: { type: "boolean" }, issueId: { type: "string" }, labelId: { type: "string" } } } }; /** * Tool definition for assigning an issue to a user */ export const assignIssueToolDefinition: MCPToolDefinition = { name: "linear_assignIssue", description: "Assign an issue to a user", input_schema: { type: "object", properties: { issueId: { type: "string", description: "ID or identifier of the issue to assign (e.g., ABC-123)", }, assigneeId: { type: "string", description: "ID of the user to assign the issue to, or null to unassign", }, }, required: ["issueId", "assigneeId"], }, output_schema: { type: "object", properties: { success: { type: "boolean" }, issue: { type: "object", properties: { id: { type: "string" }, identifier: { type: "string" }, title: { type: "string" }, assignee: { type: "object" }, url: { type: "string" } } } } } }; /** * Tool definition for subscribing to issue updates */ export const subscribeToIssueToolDefinition: MCPToolDefinition = { name: "linear_subscribeToIssue", description: "Subscribe to issue updates", input_schema: { type: "object", properties: { issueId: { type: "string", description: "ID or identifier of the issue to subscribe to (e.g., ABC-123)", }, }, required: ["issueId"], }, output_schema: { type: "object", properties: { success: { type: "boolean" }, message: { type: "string" } } } }; /** * Tool definition for converting an issue to a subtask */ export const convertIssueToSubtaskToolDefinition: MCPToolDefinition = { name: "linear_convertIssueToSubtask", description: "Convert an issue to a subtask", input_schema: { type: "object", properties: { issueId: { type: "string", description: "ID or identifier of the issue to convert (e.g., ABC-123)", }, parentIssueId: { type: "string", description: "ID or identifier of the parent issue (e.g., ABC-456)", }, }, required: ["issueId", "parentIssueId"], }, output_schema: { type: "object", properties: { success: { type: "boolean" }, issue: { type: "object", properties: { id: { type: "string" }, identifier: { type: "string" }, title: { type: "string" }, parent: { type: "object" }, url: { type: "string" } } } } } }; /** * Tool definition for creating issue relations */ export const createIssueRelationToolDefinition: MCPToolDefinition = { name: "linear_createIssueRelation", description: "Create relations between issues (blocks, is blocked by, etc.)", input_schema: { type: "object", properties: { issueId: { type: "string", description: "ID or identifier of the first issue (e.g., ABC-123)", }, relatedIssueId: { type: "string", description: "ID or identifier of the second issue (e.g., ABC-456)", }, type: { type: "string", description: "Type of relation: 'blocks', 'blocked_by', 'related', 'duplicate', 'duplicate_of'", enum: ["blocks", "blocked_by", "related", "duplicate", "duplicate_of"] }, }, required: ["issueId", "relatedIssueId", "type"], }, output_schema: { type: "object", properties: { success: { type: "boolean" }, relation: { type: "object", properties: { id: { type: "string" }, type: { type: "string" }, issueIdentifier: { type: "string" }, relatedIssueIdentifier: { type: "string" } } } } } }; /** * Tool definition for archiving an issue */ export const archiveIssueToolDefinition: MCPToolDefinition = { name: "linear_archiveIssue", description: "Archive an issue", input_schema: { type: "object", properties: { issueId: { type: "string", description: "ID or identifier of the issue to archive (e.g., ABC-123)", }, }, required: ["issueId"], }, output_schema: { type: "object", properties: { success: { type: "boolean" }, message: { type: "string" } } } }; /** * Tool definition for setting issue priority */ export const setIssuePriorityToolDefinition: MCPToolDefinition = { name: "linear_setIssuePriority", description: "Set the priority of an issue", input_schema: { type: "object", properties: { issueId: { type: "string", description: "ID or identifier of the issue (e.g., ABC-123)", }, priority: { type: "number", description: "Priority level (0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low)", enum: [0, 1, 2, 3, 4] }, }, required: ["issueId", "priority"], }, output_schema: { type: "object", properties: { success: { type: "boolean" }, issue: { type: "object", properties: { id: { type: "string" }, identifier: { type: "string" }, title: { type: "string" }, priority: { type: "number" }, url: { type: "string" } } } } } }; /** * Tool definition for transferring an issue to another team */ export const transferIssueToolDefinition: MCPToolDefinition = { name: "linear_transferIssue", description: "Transfer an issue to another team", input_schema: { type: "object", properties: { issueId: { type: "string", description: "ID or identifier of the issue to transfer (e.g., ABC-123)", }, teamId: { type: "string", description: "ID of the team to transfer the issue to", }, }, required: ["issueId", "teamId"], }, output_schema: { type: "object", properties: { success: { type: "boolean" }, issue: { type: "object", properties: { id: { type: "string" }, identifier: { type: "string" }, title: { type: "string" }, team: { type: "object" }, url: { type: "string" } } } } } }; /** * Tool definition for duplicating an issue */ export const duplicateIssueToolDefinition: MCPToolDefinition = { name: "linear_duplicateIssue", description: "Duplicate an issue", input_schema: { type: "object", properties: { issueId: { type: "string", description: "ID or identifier of the issue to duplicate (e.g., ABC-123)", }, }, required: ["issueId"], }, output_schema: { type: "object", properties: { success: { type: "boolean" }, originalIssue: { type: "object", properties: { id: { type: "string" }, identifier: { type: "string" }, title: { type: "string" } } }, duplicatedIssue: { type: "object", properties: { id: { type: "string" }, identifier: { type: "string" }, title: { type: "string" }, url: { type: "string" } } } } } }; /** * Tool definition for getting issue history */ export const getIssueHistoryToolDefinition: MCPToolDefinition = { name: "linear_getIssueHistory", description: "Get the history of changes made to an issue", input_schema: { type: "object", properties: { issueId: { type: "string", description: "ID or identifier of the issue (e.g., ABC-123)", }, limit: { type: "number", description: "Maximum number of history events to return (default: 10)", }, }, required: ["issueId"], }, output_schema: { type: "object", properties: { issueId: { type: "string" }, identifier: { type: "string" }, history: { type: "array", items: { type: "object", properties: { id: { type: "string" }, createdAt: { type: "string" }, actor: { type: "object" }, type: { type: "string" }, from: { type: "string" }, to: { type: "string" } } } } } } }; /** * Tool definition for getting comments for an issue */ export const getCommentsToolDefinition: MCPToolDefinition = { name: "linear_getComments", description: "Get all comments for an issue", input_schema: { type: "object", properties: { issueId: { type: "string", description: "ID or identifier of the issue to get comments from (e.g., ABC-123)", }, limit: { type: "number", description: "Maximum number of comments to return (default: 25)", }, }, required: ["issueId"], }, output_schema: { type: "array", items: { type: "object", properties: { id: { type: "string" }, body: { type: "string" }, createdAt: { type: "string" }, user: { type: "object", properties: { id: { type: "string" }, name: { type: "string" } } }, url: { type: "string" } } } } };