linear_getInitiatives

Retrieve all initiatives from Linear project management, including archived items with optional filters for managing project workflows.

Instructions

Get a list of all initiatives from Linear

Input Schema

TableJSON Schema

Name	Required	Description	Default
`includeArchived`	No	Include archived initiatives in the results
`limit`	No	Maximum number of initiatives to return

Implementation Reference

src/tools/handlers/initiative-handlers.ts:14-25 (handler)

The handler function for the 'linear_getInitiatives' tool. It validates the input using a type guard, logs the action, fetches initiatives via LinearService, and returns the list.

export function getInitiativesHandler(linearService: LinearService) {
  return async (args: unknown) => {
    if (!isGetInitiativesInput(args)) {
      throw new Error('Invalid input for getInitiatives');
    }

    console.log('[getInitiatives] Fetching initiatives with options:', args);
    const initiatives = await linearService.getInitiatives(args);
    console.log(`[getInitiatives] Retrieved ${initiatives.length} initiatives`);
    return initiatives;
  };
}

src/tools/definitions/initiative-tools.ts:4-48 (schema)

The MCP tool definition for 'linear_getInitiatives', including input and output schemas.

{
  name: 'linear_getInitiatives',
  description: 'Get a list of all initiatives from Linear',
  input_schema: {
    type: 'object',
    properties: {
      includeArchived: {
        type: 'boolean',
        description: 'Include archived initiatives in the results',
        default: false,
      },
      limit: {
        type: 'number',
        description: 'Maximum number of initiatives to return',
        default: 50,
      },
    },
  },
  output_schema: {
    type: 'array',
    items: {
      type: 'object',
      properties: {
        id: { type: 'string' },
        name: { type: 'string' },
        description: { type: 'string' },
        content: { type: 'string' },
        icon: { type: 'string' },
        color: { type: 'string' },
        status: { type: 'string' },
        targetDate: { type: 'string' },
        sortOrder: { type: 'number' },
        owner: {
          type: 'object',
          properties: {
            id: { type: 'string' },
            name: { type: 'string' },
            email: { type: 'string' },
          },
        },
        url: { type: 'string' },
      },
    },
  },
},

src/tools/handlers/index.ts:91-91 (registration)
Registration of the 'linear_getInitiatives' handler in the tool handlers map.
```
linear_getInitiatives: getInitiativesHandler(linearService),
```

src/tools/type-guards.ts:723-734 (schema)

Type guard function for validating input arguments to the 'linear_getInitiatives' tool.

export function isGetInitiativesInput(args: unknown): args is {
  includeArchived?: boolean;
  limit?: number;
} {
  return (
    typeof args === 'object' &&
    args !== null &&
    (!('includeArchived' in args) ||
      typeof (args as { includeArchived: boolean }).includeArchived === 'boolean') &&
    (!('limit' in args) || typeof (args as { limit: number }).limit === 'number')
  );
}

Linear