Linear MCP Server

Instructions

Implementation Reference

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

  Handler function that implements the core logic for the linear_getTeams tool by calling linearService.getTeams().

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

• src/tools/definitions/team-tools.ts:6-35 (schema)

  Tool schema definition including input (empty) and output schema for teams list with id, name, key, description, and states.

  export const getTeamsToolDefinition: MCPToolDefinition = {
    name: "linear_getTeams",
    description: "Get a list of teams from Linear",
    input_schema: {
      type: "object",
      properties: {},
    },
    output_schema: {
      type: "array",
      items: {
        type: "object",
        properties: {
          id: { type: "string" },
          name: { type: "string" },
          key: { type: "string" },
          description: { type: "string" },
          states: {
            type: "array",
            items: {
              type: "object",
              properties: {
                id: { type: "string" },
                name: { type: "string" }
              }
            }
          }
        }
      }
    }
  }; 

• src/tools/handlers/index.ts:59-61 (registration)

  Registration of the linear_getTeams handler within the registerToolHandlers function.

  // Team tools
  linear_getTeams: handleGetTeams(linearService),
  linear_getWorkflowStates: handleGetWorkflowStates(linearService),