linear_addIssueToCycle

Add a Linear issue to a project cycle to organize work and track progress within scheduled timeframes.

Instructions

Add an issue to a cycle

Input Schema

TableJSON Schema

Name	Required	Description	Default
`issueId`	Yes	ID or identifier of the issue to add to the cycle
`cycleId`	Yes	ID of the cycle to add the issue to

Implementation Reference

src/tools/handlers/cycle-handlers.ts:44-57 (handler)

The core handler function that implements the logic for the linear_addIssueToCycle tool. It validates the input arguments using the type guard and delegates to the LinearService.

export function handleAddIssueToCycle(linearService: LinearService) {
  return async (args: unknown) => {
    try {
      if (!isAddIssueToCycleArgs(args)) {
        throw new Error("Invalid arguments for addIssueToCycle");
      }
      
      return await linearService.addIssueToCycle(args.issueId, args.cycleId);
    } catch (error) {
      logError("Error adding issue to cycle", error);
      throw error;
    }
  };
}

src/tools/definitions/cycle-tools.ts:90-129 (schema)

The input and output schema definition for the linear_addIssueToCycle tool.

export const addIssueToCycleToolDefinition: MCPToolDefinition = {
  name: "linear_addIssueToCycle",
  description: "Add an issue to a cycle",
  input_schema: {
    type: "object",
    properties: {
      issueId: {
        type: "string",
        description: "ID or identifier of the issue to add to the cycle",
      },
      cycleId: {
        type: "string",
        description: "ID of the cycle to add the issue to",
      },
    },
    required: ["issueId", "cycleId"],
  },
  output_schema: {
    type: "object",
    properties: {
      success: { type: "boolean" },
      issue: {
        type: "object",
        properties: {
          id: { type: "string" },
          identifier: { type: "string" },
          title: { type: "string" },
          cycle: {
            type: "object",
            properties: {
              id: { type: "string" },
              number: { type: "number" },
              name: { type: "string" },
            }
          }
        }
      }
    }
  }
};

src/tools/handlers/index.ts:72-76 (registration)

Registration of the linear_addIssueToCycle handler within the registerToolHandlers function.

// Cycle Management tools
linear_getCycles: handleGetCycles(linearService),
linear_getActiveCycle: handleGetActiveCycle(linearService),
linear_addIssueToCycle: handleAddIssueToCycle(linearService),

src/tools/type-guards.ts:498-510 (helper)

Type guard function used in the handler to validate input arguments for linear_addIssueToCycle.

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

Linear MCP Server