linear_getIssueById

Retrieve a specific issue from Linear project management using its ID or identifier (like ABC-123) to access details and manage tasks.

Instructions

Get a specific issue by ID or identifier (e.g., ABC-123)

Input Schema

TableJSON Schema

Name	Required	Description	Default
`id`	Yes	The ID or identifier of the issue (e.g., ABC-123)

Implementation Reference

src/tools/handlers/issue-handlers.ts:26-39 (handler)

The main handler function that implements the linear_getIssueById tool logic. It validates the input arguments using the isGetIssueByIdArgs type guard and delegates to LinearService.getIssueById to fetch and return the specific issue.

export function handleGetIssueById(linearService: LinearService) {
  return async (args: unknown) => {
    try {
      if (!isGetIssueByIdArgs(args)) {
        throw new Error("Invalid arguments for getIssueById");
      }
      
      return await linearService.getIssueById(args.id);
    } catch (error) {
      logError("Error getting issue by ID", error);
      throw error;
    }
  };
}

src/tools/definitions/issue-tools.ts:59-106 (schema)

Defines the MCP tool schema for linear_getIssueById, specifying input (id: string required) and comprehensive output schema for issue details.

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" }
    }
  }
};

src/tools/handlers/index.ts:79-79 (registration)
Registers the tool name 'linear_getIssueById' to the handleGetIssueById handler function (curried with LinearService instance) within the registerToolHandlers export.
```
linear_getIssueById: handleGetIssueById(linearService),
```

src/tools/type-guards.ts:15-22 (helper)

Type guard utility function used by the handler to validate and type-narrow the tool's input arguments to ensure 'id' is a string.

export function isGetIssueByIdArgs(args: unknown): args is { id: string } {
  return (
    typeof args === "object" &&
    args !== null &&
    "id" in args &&
    typeof (args as { id: string }).id === "string"
  );
}

Linear MCP Server