linear_getCycles
Retrieve a list of cycles from Linear, optionally filtering by team and limiting the number of results. Ideal for project tracking and cycle management.
Instructions
Get a list of all cycles
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of cycles to return (default: 25) | |
| teamId | No | ID of the team to get cycles for (optional) |
Implementation Reference
- The handler function for the linear_getCycles tool. It validates the input arguments using a type guard and delegates to LinearService.getCycles.export function handleGetCycles(linearService: LinearService) { return async (args: unknown) => { try { if (!isGetCyclesArgs(args)) { throw new Error('Invalid arguments for getCycles'); } return await linearService.getCycles(args.teamId, args.limit); } catch (error) { logError('Error getting cycles', error); throw error; } }; }
- MCP tool definition for linear_getCycles, specifying name, description, input schema (teamId?, limit?), and output schema (array of cycle objects).export const getCyclesToolDefinition: MCPToolDefinition = { name: 'linear_getCycles', description: 'Get a list of all cycles', input_schema: { type: 'object', properties: { teamId: { type: 'string', description: 'ID of the team to get cycles for (optional)', }, limit: { type: 'number', description: 'Maximum number of cycles to return (default: 25)', }, }, }, output_schema: { type: 'array', items: { type: 'object', properties: { id: { type: 'string' }, number: { type: 'number' }, name: { type: 'string' }, description: { type: 'string' }, startsAt: { type: 'string' }, endsAt: { type: 'string' }, completedAt: { type: 'string' }, team: { type: 'object', properties: { id: { type: 'string' }, name: { type: 'string' }, key: { type: 'string' }, }, }, }, }, }, };
- src/tools/handlers/index.ts:86-86 (registration)Maps the tool name 'linear_getCycles' to its handler function in the registerToolHandlers function.linear_getCycles: handleGetCycles(linearService),
- src/tools/type-guards.ts:649-661 (helper)Type guard function isGetCyclesArgs used by the handler to validate input arguments.* Type guard for linear_getCycles tool arguments */ export function isGetCyclesArgs(args: unknown): args is { teamId?: string; limit?: number; } { return ( typeof args === 'object' && args !== null && (!('teamId' in args) || typeof (args as { teamId: string }).teamId === 'string') && (!('limit' in args) || typeof (args as { limit: number }).limit === 'number') ); }