Metal-organic frameworks (MOFs) have emerged as highly promising adsorbents for removing heavy metals from wastewater due to their tunable structures, high surface areas, and exceptional adsorption capacities. This review meticulously examines and summarizes recent advancements in producing and utilizing MOF-based adsorbents for sequestering heavy metal ions from water. It begins by outlining and contrasting commonly employed methods for synthesizing MOFs, such as solvothermal, microwave, electrochemical, ultrasonic, and mechanochemical. Rather than delving into the specifics of adsorption process parameters, the focus shifts to analyzing the adsorption capabilities and underlying mechanisms against critical metal(loid) ions like chromium, arsenic, lead, cadmium, and mercury under various environmental conditions. Additionally, this article discusses strategies to optimize MOF performance, scale-up production, and address environmental implications. The comprehensive review aims to enhance the understanding of MOF-based adsorption for heavy metal remediation and stimulate further research in this critical field. In brief, this review article presents a comprehensive overview of the contemporary information on MOFs as an effective adsorbent and the challenges being faced by these adsorbents for heavy metal mitigation (including stability, cost, environmental issues, and optimization), targeting to develop a vital reference for future MOF research. © The Author(s), under exclusive licence to Springer-Verlag GmbH Germany, part of Springer Nature 2024.