MCP Linear App

Instructions

Implementation Reference

• src/tools/linear/get-team-id.ts:46-100 (handler)

  The main handler implementation for the 'get_team_id' tool. It fetches teams using linearClient.teams(), processes the data, formats it using a helper function, and returns a text response with team IDs.

  export const LinearGetTeamIdTool = createSafeTool({
    name: "get_team_id",
    description: "A tool that gets all teams and their IDs from Linear",
    schema: z.object({}).shape,
    handler: async () => {
      try {
        // Get teams from Linear
        const teamsResponse = await linearClient.teams();
        
        if (!teamsResponse || !teamsResponse.nodes) {
          return {
            content: [{
              type: "text",
              text: "Could not retrieve teams from Linear. Please check your connection or permissions.",
            }],
          };
        }
        
        // Convert to TeamData format for safe processing
        const teams: TeamData[] = teamsResponse.nodes.map(team => ({
          id: team.id || "unknown-id",
          name: team.name || "Unnamed Team",
          key: team.key || "unknown-key",
          description: team.description,
          color: team.color,
          createdAt: team.createdAt,
          updatedAt: team.updatedAt,
          issueCount: team.issueCount,
          private: team.private,
          // Generate a URL if not available directly from the API
          url: `https://linear.app/team/${team.key}`
        }));
        
        // Format teams to human-readable text
        const formattedText = formatTeamsToHumanReadable(teams);
        
        // Return formatted text
        return {
          content: [{
            type: "text",
            text: formattedText,
          }],
        };
      } catch (error) {
        // Handle errors gracefully
        const errorMessage = error instanceof Error ? error.message : "Unknown error";
        return {
          content: [{
            type: "text",
            text: `An error occurred while retrieving teams:\n${errorMessage}`,
          }],
        };
      }
    }
  }); 

• src/tools/linear/get-team-id.ts:8-19 (schema)

  TypeScript interface defining the structure of team data used within the tool handler for type safety.

  interface TeamData {
    id: string;
    name: string;
    key: string;
    description?: string;
    color?: string;
    createdAt?: string | Date;
    updatedAt?: string | Date;
    issueCount?: number;
    private?: boolean;
    url?: string;
  }

• src/tools/linear/get-team-id.ts:26-41 (helper)

  Helper function that formats an array of TeamData objects into a human-readable string listing team IDs.

  function formatTeamsToHumanReadable(teams: TeamData[]): string {
    if (!teams || teams.length === 0) {
      return "No teams found in your Linear workspace.";
    }
  
    let result = "";
    
    teams.forEach((team, index) => {
      if (index > 0) {
        result += "\n";
      }
      result += `Team ID: ${team.id}`;
    });
    
    return result;
  }

• src/index.ts:31-41 (registration)

  Registers the LinearGetTeamIdTool (and other Linear tools) with the MCP server using the registerTool utility.

  registerTool(server, [
    LinearSearchIssuesTool,
    LinearGetProfileTool,
    LinearCreateIssueTool,
    LinearCreateCommentTool,
    LinearUpdateCommentTool,
    LinearGetIssueTool,
    LinearGetTeamIdTool,
    LinearUpdateIssueTool,
    LinearGetCommentTool,
  ]);