Linear MCP Server

Instructions

Implementation Reference

• src/tools/handlers/user-handlers.ts:49-58 (handler)

  The handler function for linear_getLabels tool. It wraps the linearService.getLabels() call with error handling.

  export function handleGetLabels(linearService: LinearService) {
    return async (args: unknown) => {
      try {
        return await linearService.getLabels();
      } catch (error) {
        logError("Error getting labels", error);
        throw error;
      }
    };
  } 

• src/tools/definitions/user-tools.ts:81-107 (schema)

  The schema definition for the linear_getLabels tool, including input (empty) and output schema for labels.

  export const getLabelsToolDefinition: MCPToolDefinition = {
    name: "linear_getLabels",
    description: "Get a list of issue labels from Linear",
    input_schema: {
      type: "object",
      properties: {},
    },
    output_schema: {
      type: "array",
      items: {
        type: "object",
        properties: {
          id: { type: "string" },
          name: { type: "string" },
          description: { type: "string" },
          color: { type: "string" },
          team: {
            type: "object",
            properties: {
              id: { type: "string" },
              name: { type: "string" }
            }
          }
        }
      }
    }
  }; 

• src/tools/handlers/index.ts:57-57 (registration)

  Registration of the linear_getLabels tool handler in the tool handlers map.

  linear_getLabels: handleGetLabels(linearService),