linear_getProjectIssues

Retrieve all issues from a Linear project to track tasks, identify blockers, and monitor progress. Specify a project ID to get relevant issues with optional limit control.

Instructions

Get all issues associated with a project

Input Schema

TableJSON Schema

Name	Required	Description	Default
`projectId`	Yes	ID of the project to get issues for
`limit`	No	Maximum number of issues to return (default: 25)

Implementation Reference

src/tools/handlers/project-handlers.ts:78-94 (handler)

The handler function that implements the core logic of the linear_getProjectIssues tool. It validates the input arguments using a type guard and delegates to the LinearService.getProjectIssues method.

/**
 * Handler for getting issues in a project
 */
export function handleGetProjectIssues(linearService: LinearService) {
  return async (args: unknown) => {
    try {
      if (!isGetProjectIssuesArgs(args)) {
        throw new Error('Invalid arguments for getProjectIssues');
      }

      return await linearService.getProjectIssues(args.projectId, args.limit);
    } catch (error) {
      logError('Error getting project issues', error);
      throw error;
    }
  };
}

src/tools/definitions/project-tools.ts:174-208 (schema)

The MCP tool definition (schema) for linear_getProjectIssues, specifying input parameters (projectId required, optional limit) and output structure (array of issue objects).

export const getProjectIssuesToolDefinition: MCPToolDefinition = {
  name: 'linear_getProjectIssues',
  description: 'Get all issues associated with a project',
  input_schema: {
    type: 'object',
    properties: {
      projectId: {
        type: 'string',
        description: 'ID of the project to get issues for',
      },
      limit: {
        type: 'number',
        description: 'Maximum number of issues to return (default: 25)',
      },
    },
    required: ['projectId'],
  },
  output_schema: {
    type: 'array',
    items: {
      type: 'object',
      properties: {
        id: { type: 'string' },
        identifier: { type: 'string' },
        title: { type: 'string' },
        description: { type: 'string' },
        state: { type: 'string' },
        priority: { type: 'number' },
        team: { type: 'object' },
        assignee: { type: 'object' },
        url: { type: 'string' },
      },
    },
  },
};

src/tools/handlers/index.ts:81-84 (registration)
Registration of the linear_getProjectIssues handler within the registerToolHandlers function, mapping the tool name to the handleGetProjectIssues factory.
```
linear_updateProject: handleUpdateProject(linearService),
linear_addIssueToProject: handleAddIssueToProject(linearService),
linear_getProjectIssues: handleGetProjectIssues(linearService),
```

src/tools/type-guards.ts:466-477 (helper)

Type guard function used by the handler to validate input arguments for the linear_getProjectIssues tool.

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

Linear