Skip to content
MyCal Docs

MyCal Documentation

Malaysia's most complete calendar API. Public holidays, school calendar, exam schedules, business day calculator.
Quick Start Try the demo GitHub

Three ways to use it

  • REST API — plain HTTP, any language
  • TypeScript SDK — npm i @catlabtech/mycal-sdk with fully typed responses
  • MCP Server — 12 tools for Claude, ChatGPT, and other AI agents
  • iCal Subscription — drop into Google, Apple, or Outlook calendar

Why MyCal

  • 49 public holidays for 2026 from the official JPM gazette
  • 16 states + 3 Federal Territories with correct weekend config (Kedah/Kelantan/Terengganu use Fri–Sat)
  • Cuti ganti automatically calculated when holidays fall on weekends
  • School calendar including KPM terms, cuti penggal, cuti perayaan
  • Exam schedules — SPM, STPM, MUET, PT3
  • Trilingual — Bahasa Melayu, English, 中文

Data provenance

Every holiday record includes a gazette reference (e.g. GN-33499) so you can trace it back to the official Warta Kerajaan. Data is sourced exclusively from:

  • JPM BKPP — Federal and state gazettes
  • JAKIM — Takwim Hijri-Miladi
  • KPM — Kalendar Akademik (school calendar)
  • MPM — STPM and MUET schedules
  • State government portals — state-specific holidays