Mycal MCP server

by Junhui20·io.github.Junhui20/mycal·v0.1.4·3 stars

No reviews yet

Malaysia public holidays, school terms, business days & a leave optimizer (13 tools).

A92/100grade A

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

A92/100

full report

Adoption

Growing

3 stars43 downloads/wk

Reviews

Write one

Nobody has reviewed Mycal yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Mycal tools (13)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

check_malaysia_holiday
Check if a specific date is a public holiday, weekend, or working day in Malaysia. Returns holiday details, school day status. Use when user asks 'is X a holiday?', 'do I work on X?'.
get_malaysia_holidays
Get Malaysia public holidays. Covers all 16 regions (13 states + 3 federal territories) including Islamic holidays with tentative/confirmed status.
list_malaysia_states
List all 16 Malaysian regions (13 states + 3 federal territories) with weekend configurations and group assignments.
malaysia_business_days
Count business/working days between two dates for a Malaysian state. Excludes weekends and public holidays.
malaysia_exams
Get Malaysia public exam schedule \u2014 SPM, STPM, MUET, PT3. Includes results announcement dates.
malaysia_holiday_changes
Get recent changes to Malaysia holiday data (new holidays, confirmations, ad-hoc announcements).
malaysia_is_school_day
Check if a date is a school day in Malaysia. Accepts state (auto-resolves to group) or group directly. Combines public holidays, school holidays, and weekend status.
malaysia_leave_optimizer
Find the most efficient annual-leave days to take to maximise consecutive days off in Malaysia (e.g. 'take 2 days \u2192 get 5 off'). Ideal for planning trips around public holidays and weekends, per state.
malaysia_long_weekends
Find all long weekends (3+ consecutive non-working days) in Malaysia for a given year.
malaysia_school_holidays
Get Malaysia school holidays including cuti penggal, mid-year break, year-end break, and KPM bonus holidays.
malaysia_school_terms
Get Malaysia school term dates and day counts. Group A = Kedah/Kelantan/Terengganu, Group B = all other states.
next_malaysia_holiday
Find the next upcoming public holiday in Malaysia. Use when user asks 'when is the next holiday?'.
resolve_malaysia_state
Resolve a state name or alias (e.g. 'KL', 'Penang', 'JB') to the canonical state code.

Public scan report

scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it

no findings

Code scan3 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 11 days ago15/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Overall 92/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Mycal compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 92/100; higher than 95% of 48,255 servers
Tools: 13; the typical server has 7
Tools that change things: 0%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 3; more than 80% of 28,688 servers
Downloads a week: 43; more than 35% of 12,191 servers with a package

What its tools let an agent do: 13 read

Install Mycal in Claude Code, Cursor or VS Code

Runs npx -y @catlabtech/mycal-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add mycal -- npx -y @catlabtech/mycal-mcp-server

Add to Cursor

What the publisher says

From the Mycal repository's README, as published. We do not edit it. Read it on GitHub

Malaysia Calendar API

Malaysia's most complete calendar API — public holidays, school calendar, exam schedules, and MCP server for AI tools.

Data source: Official government gazette (JPM BKPP), JAKIM, KPM, MPM. Not scraped from third-party websites.

Packages

Published to npm under the @catlabtech scope:

Features

49 public holidays for 2026 from official gazette (Warta Kerajaan) — federal + state-specific
16 states + 3 Federal Territories with aliases (KL, JB, Penang, etc.)
Weekend-aware — Kedah/Kelantan/Terengganu use Fri-Sat (Kumpulan A), all others use Sat-Sun (Kumpulan B), with Johor's historical switch tracked
Cuti ganti (replacement holiday) auto-calculation per state weekend config
Business day calculator — per-state, holiday-aware
School calendar — terms, holidays, KPM cuti perayaan (Lampiran A/B/C)
Exam schedules — SPM, STPM, MUET, PT3
iCal subscription feeds — per-state .ics feeds
MCP Server for AI agents — 13 tools for Claude, ChatGPT, and other assistants
TypeScript SDK (@catlabtech/mycal-sdk) with typed responses
OpenAPI 3.1 spec + interactive docs
Trilingual — Bahasa Melayu, English, Chinese names (三语支持)

Quick Start

# Clone and install
git clone https://github.com/Junhui20/malaysia-calendar-api.git
cd malaysia-calendar-api
pnpm install

# Build shared packages
pnpm --filter @catlabtech/mycal-core build
pnpm --filter @catlabtech/mycal-sdk build

# Run API locally (http://localhost:8787)
cd packages/api && npx wrangler dev

# Run web site locally (http://localhost:4321)
pnpm --filter @mycal/web dev

# Validate data
pnpm validate

# Run tests
pnpm test

API Examples

Base URL: https://mycal-api.huijun00100101.workers.dev/v1

List holidays

# All holidays for Selangor in 2026
curl "https://mycal-api.huijun00100101.workers.dev/v1/holidays?year=2026&state=selangor"

# Islamic holidays only
curl "https://mycal-api.huijun00100101.workers.dev/v1/holidays?year=2026&type=islamic"

# March holidays for KL
curl "https://mycal-api.huijun00100101.workers.dev/v1/holidays?year=2026&state=KL&month=3"

Check a date

# Is March 21 a holiday/weekend/working day?
curl "https://mycal-api.huijun00100101.workers.dev/v1/holidays/check?date=2026-03-21&state=KL"

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Mycal: common questions

Is Mycal MCP server safe?: Yes, by our scan: it is graded A (92/100). Read the Mycal safety report
How do I install Mycal?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Mycal need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Mycal maintained?: The last commit was 50 days ago (2026-09-15). The latest release is v0.1.4.
How does Mycal compare with other MCP servers?: safety score 92/100 (higher than 95% of 48,255 servers); tools 13 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.