linear_getProjects

Retrieve a list of projects from Linear's project management system to view, organize, and manage team workflows and tasks.

Instructions

Get a list of projects from Linear

Input Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Implementation Reference

src/tools/handlers/project-handlers.ts:8-17 (handler)

The primary handler function for the 'linear_getProjects' tool. It takes no input arguments (as per schema), calls LinearService.getProjects(), and handles errors by logging and rethrowing.

export function handleGetProjects(linearService: LinearService) {
  return async (args: unknown) => {
    try {
      return await linearService.getProjects();
    } catch (error) {
      logError("Error getting projects", error);
      throw error;
    }
  };
}

src/tools/definitions/project-tools.ts:6-36 (schema)

Tool schema definition specifying empty input and detailed output structure for projects including id, name, description, state, teams array, and url.

export const getProjectsToolDefinition: MCPToolDefinition = {
  name: "linear_getProjects",
  description: "Get a list of projects from Linear",
  input_schema: {
    type: "object",
    properties: {},
  },
  output_schema: {
    type: "array",
    items: {
      type: "object",
      properties: {
        id: { type: "string" },
        name: { type: "string" },
        description: { type: "string" },
        state: { type: "string" },
        teams: {
          type: "array",
          items: {
            type: "object",
            properties: {
              id: { type: "string" },
              name: { type: "string" }
            }
          }
        },
        url: { type: "string" }
      }
    }
  }
};

src/tools/handlers/index.ts:64-64 (registration)
Tool registration mapping the name 'linear_getProjects' to its handler function within the registerToolHandlers export.
```
linear_getProjects: handleGetProjects(linearService),
```

src/services/linear-service.ts:79-98 (helper)

Core service method implementing the project fetching logic using Linear client SDK, resolving projects and their teams asynchronously. Called by the tool handler.

async getProjects() {
  const projects = await this.client.projects();
  return Promise.all(
    projects.nodes.map(async (project) => {
      // We need to fetch teams using the relationship
      const teams = await project.teams();

      return {
        id: project.id,
        name: project.name,
        description: project.description,
        state: project.state,
        teams: teams.nodes.map((team) => ({
          id: team.id,
          name: team.name,
        })),
      };
    }),
  );
}

Linear MCP Server