linear_getWorkflowStates

Retrieve workflow states for a Linear team to understand project statuses and manage issue progression.

Instructions

Get workflow states for a team

Input Schema

TableJSON Schema

Name	Required	Description	Default
`teamId`	Yes	ID of the team to get workflow states for
`includeArchived`	No	Whether to include archived states (default: false)

Implementation Reference

src/tools/handlers/team-handlers.ts:19-37 (handler)

Handler function that implements the core logic of the linear_getWorkflowStates tool. Validates arguments using type guard and delegates to LinearService.getWorkflowStates.

/**
 * Handler for getting workflow states for a team
 */
export function handleGetWorkflowStates(linearService: LinearService) {
  return async (args: unknown) => {
    try {
      if (!isGetWorkflowStatesArgs(args)) {
        throw new Error("Invalid arguments for getWorkflowStates");
      }
      
      return await linearService.getWorkflowStates(
        args.teamId, 
        args.includeArchived || false
      );
    } catch (error) {
      logError("Error getting workflow states", error);
      throw error;
    }
  };

src/tools/definitions/team-tools.ts:39-71 (schema)

MCP tool definition specifying name, description, input_schema (teamId required, includeArchived optional boolean), and output_schema for workflow state objects.

 */
export const getWorkflowStatesToolDefinition: MCPToolDefinition = {
  name: "linear_getWorkflowStates",
  description: "Get workflow states for a team",
  input_schema: {
    type: "object",
    properties: {
      teamId: {
        type: "string",
        description: "ID of the team to get workflow states for",
      },
      includeArchived: {
        type: "boolean",
        description: "Whether to include archived states (default: false)",
      },
    },
    required: ["teamId"],
  },
  output_schema: {
    type: "array",
    items: {
      type: "object",
      properties: {
        id: { type: "string" },
        name: { type: "string" },
        type: { type: "string" },
        position: { type: "number" },
        color: { type: "string" },
        description: { type: "string" }
      }
    }
  }
};

src/tools/handlers/index.ts:60-61 (registration)
Registration of the linear_getWorkflowStates handler within the registerToolHandlers function's return object.
```
linear_getTeams: handleGetTeams(linearService),
linear_getWorkflowStates: handleGetWorkflowStates(linearService),
```

src/tools/type-guards.ts:513-536 (helper)

Type guard helper function used by the handler to validate input arguments for teamId (string, required) and includeArchived (boolean, optional).

 * Type guard for linear_getWorkflowStates tool arguments
 */
export function isGetWorkflowStatesArgs(args: unknown): args is {
  teamId: string;
  includeArchived?: boolean;
} {
  if (
    typeof args !== "object" ||
    args === null ||
    !("teamId" in args) ||
    typeof (args as { teamId: string }).teamId !== "string"
  ) {
    return false;
  }

  if (
    "includeArchived" in args &&
    typeof (args as { includeArchived: boolean }).includeArchived !== "boolean"
  ) {
    return false;
  }

  return true;
}

src/tools/definitions/index.ts:54-56 (registration)
Inclusion of the linear_getWorkflowStates tool definition in the allToolDefinitions array for overall tool registration.
```
// Team tools
getTeamsToolDefinition,
getWorkflowStatesToolDefinition,
```

Linear MCP Server