Linear MCP Server

Instructions

Implementation Reference

• src/tools/handlers/user-handlers.ts:35-44 (handler)

  The main handler function for the 'linear_getUsers' tool. It wraps the call to linearService.getAllUsers() in an async function with error handling.

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

• src/tools/definitions/user-tools.ts:56-76 (schema)

  Tool schema definition specifying the name, description, empty input schema, and output schema as an array of user objects.

  export const getUsersToolDefinition: MCPToolDefinition = {
    name: "linear_getUsers",
    description: "Get a list of users in the Linear organization",
    input_schema: {
      type: "object",
      properties: {},
    },
    output_schema: {
      type: "array",
      items: {
        type: "object",
        properties: {
          id: { type: "string" },
          name: { type: "string" },
          email: { type: "string" },
          displayName: { type: "string" },
          active: { type: "boolean" }
        }
      }
    }
  };

• src/tools/handlers/index.ts:54-57 (registration)

  Tool registration within the registerToolHandlers function, mapping 'linear_getUsers' to the handleGetUsers handler.

  linear_getViewer: handleGetViewer(linearService),
  linear_getOrganization: handleGetOrganization(linearService),
  linear_getUsers: handleGetUsers(linearService),
  linear_getLabels: handleGetLabels(linearService),