Skip to main content
AllMCPs
BrowseBestCategoriesStackCompareToolsGuidesBlog
Log in Submit MCP

Stay in the loop

Get new MCP servers and top picks in your inbox.

AllMCPs

The open directory for discovering and installing Model Context Protocol servers.

AllMCPs on GitHub (opens in a new tab)
Launched onTiny Startupstinystartups.com
Explore
  • Browse servers
  • Best MCP servers
  • Categories
  • MCP clients
  • Agent prompts
  • Stack Builder
  • Compare servers
  • Random discovery New
  • Submit a server
  • Pricing & Boost Boost
Learn
  • Guides hub
  • What is MCP?
  • Install guide
  • Build an MCP server
  • Deploy an MCP server
  • Security guide
  • Troubleshooting
  • MCP for SEO & AEO
  • Protocol versioning
  • Transports: stdio vs HTTP
  • State of MCP (stats)
  • Blog & updates
Tools
  • All developer tools
  • Config generator
  • Config validator
  • Config auditor
  • MCP playground
  • Token calculator
  • OpenAPI β†’ MCP
  • Badge generator
For agents
  • REST API docs
  • Trust & traffic Live
  • Remote MCP server SSE β†— (opens in a new tab)
  • llms.txt β†— (opens in a new tab)
  • Catalog JSON β†— (opens in a new tab)
Company
  • About
  • Advertise Sponsor
  • Contact
  • GitHub β†— (opens in a new tab)
  • Terms
  • Privacy
AllMCPs VerifiedAllMCPs VerifiedFeatured on Nick LaunchesFeatured on Nick LaunchesLaunch Llama NewsletterLaunch Llama NewsletterVerified DR - allmcps.comVerified DR - allmcps.comFeatured on SaaSGrowFeatured on SaaSGrowFeatured on Twelve ToolsFeatured on Twelve ToolsFeatured on Saaspa.geFeatured on Saaspa.geFeatured on Findly.toolsFeatured on Findly.toolsFeatured on Startup FameFeatured on Startup FameFeatured on LaunchKiwiFeatured on LaunchKiwiFeatured on ScrollLaunchFeatured on ScrollLaunchFeatured on DailyPingsFeatured on DailyPingsFazier badgeFazier badgeFeatured on NewTool.siteFeatured on NewTool.siteFeatured on saasfame.comFeatured on saasfame.comDR Checker - Domain RatingDR Checker - Domain RatingListed on Turbo0Listed on Turbo0Launched on LaunchBoard - Product Launch PlatformLaunched on LaunchBoard - Product Launch PlatformList on SimilarlabsList on Similarlabshttps://codetrendy.comhttps://codetrendy.comListed on DevTool.ioFeatured on BuildlistFeatured on BuildlistLaunched on Tiny StartupsFeatured on ShowMeBestAIFeatured on ShowMeBestAIFind us on LaunchZoneFind us on LaunchZoneAllMCPs VerifiedAllMCPs VerifiedFeatured on Nick LaunchesFeatured on Nick LaunchesLaunch Llama NewsletterLaunch Llama NewsletterVerified DR - allmcps.comVerified DR - allmcps.comFeatured on SaaSGrowFeatured on SaaSGrowFeatured on Twelve ToolsFeatured on Twelve ToolsFeatured on Saaspa.geFeatured on Saaspa.geFeatured on Findly.toolsFeatured on Findly.toolsFeatured on Startup FameFeatured on Startup FameFeatured on LaunchKiwiFeatured on LaunchKiwiFeatured on ScrollLaunchFeatured on ScrollLaunchFeatured on DailyPingsFeatured on DailyPingsFazier badgeFazier badgeFeatured on NewTool.siteFeatured on NewTool.siteFeatured on saasfame.comFeatured on saasfame.comDR Checker - Domain RatingDR Checker - Domain RatingListed on Turbo0Listed on Turbo0Launched on LaunchBoard - Product Launch PlatformLaunched on LaunchBoard - Product Launch PlatformList on SimilarlabsList on Similarlabshttps://codetrendy.comhttps://codetrendy.comListed on DevTool.ioFeatured on BuildlistFeatured on BuildlistLaunched on Tiny StartupsFeatured on ShowMeBestAIFeatured on ShowMeBestAIFind us on LaunchZoneFind us on LaunchZone
Β© 2026 Jackalope Digital LLC. All rights reserved.
  1. Home
  2. 🏒 Workplace & Productivity
  3. Mycal
Mycal logo
Health: ActiveRecent health check succeeded.Last checked 9/22/2026, 5:32:36 PM

Mycal

User RatingsBe the first to rate and review this MCP server! Enrichment pendingWe haven’t run our AI enrichment pass on this listing yet, so the overview, use cases, and FAQ below may be sparse or missing. We work through the catalog over time β€” check back soon.
View Repository3 GitHub StarsTotal stargazers on GitHub for the source repository (3 stars).Visit Website

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

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent β€” or use 1-click editor setup below.

Add to CursorAdd to VS Code
Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag β€” we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON β–Ύ

Client Config & Setup

Choose your client or environment
Target File:~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "mycal": {
      "command": "npx",
      "args": [
        "@catlabtech/mycal-mcp-server"
      ]
    }
  }
}

πŸ’‘ Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Install Tool Schemas (13) Directory Badge Claim listing Alternatives🏒 More in Workplace & Productivity

Capabilities & Tool Schemas (13) ~194 tokensApproximate context cost of this server’s tool schemas (~4 chars/token), before any tool is called. Actual usage depends on your client and model.Self-reported Self-reportedParsed from the repository README, not verified against a live server β€” may be incomplete or out of date.

Inspect callable tools, capabilities, and parameters exposed to AI agents by Mycal.

get_malaysia_holidays

Get public holidays (filter by year, state, type)

check_malaysia_holiday

Check if a date is a holiday or working day

next_malaysia_holiday

Find the next upcoming holiday

malaysia_business_days

Count working days between two dates

malaysia_long_weekends

Find long weekends (3+ days)

malaysia_leave_optimizer

Find the most efficient leave days to take to maximise consecutive days off

Documentation Overview

Malaysia Calendar API

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

npm: mycal-core npm: mycal-sdk npm: mycal-mcp-server License: MIT Deploys on Cloudflare

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

Links

  • Website + demo: https://mycal-web.pages.dev
  • Developer docs: https://mycal-web.pages.dev/docs
  • API base URL: https://mycal-api.huijun00100101.workers.dev/v1
  • GitHub: https://github.com/Junhui20/malaysia-calendar-api

Packages

Published to npm under the @catlabtech scope:

PackagePurposeInstall
@catlabtech/mycal-coreShared types, Zod schemas, and calendar/business-day logicnpm install @catlabtech/mycal-core
@catlabtech/mycal-sdkTypeScript client SDK for the REST APInpm install @catlabtech/mycal-sdk
@catlabtech/mycal-mcp-serverMCP server exposing 13 calendar tools for AI agentsnpm install @catlabtech/mycal-mcp-server

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

bash
# 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

bash
# 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

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

Response:

config.json
{
  "data": {
    "date": "2026-03-21",
    "dayOfWeek": "Saturday",
    "isHoliday": true,
    "isWeekend": true,
    "isWorkingDay": false,
    "isSchoolDay": false,
    "holidays": [
      {
        "id": "2026-hari-raya-aidilfitri-1",
        "name": { "ms": "Hari Raya Aidilfitri", "en": "Eid al-Fitr", "zh": "εΌ€ζ–‹θŠ‚" },
        "type": "islamic",
        "status": "confirmed"
      }
    ]
  }
}

Business days

bash
# Count working days in March for Selangor
curl "https://mycal-api.huijun00100101.workers.dev/v1/business-days?start=2026-03-01&end=2026-03-31&state=selangor"

# Add 10 business days to a date
curl "https://mycal-api.huijun00100101.workers.dev/v1/business-days/add?date=2026-03-01&days=10&state=selangor"

School calendar

bash
# Is this a school day?
curl "https://mycal-api.huijun00100101.workers.dev/v1/school/is-school-day?date=2026-03-21&state=selangor"

# School holidays for Kumpulan B
curl "https://mycal-api.huijun00100101.workers.dev/v1/school/holidays?year=2026&group=B"

# Exam schedule
curl "https://mycal-api.huijun00100101.workers.dev/v1/school/exams?year=2026&type=spm"

Next holiday

bash
# Next holiday for Penang
curl "https://mycal-api.huijun00100101.workers.dev/v1/holidays/next?state=penang"

State resolution

bash
# Resolve alias
curl "https://mycal-api.huijun00100101.workers.dev/v1/states/resolve?q=kl"
# -> { "data": { "canonical": "kuala-lumpur", "group": "B" } }

Full API Reference

EndpointDescription
GET /v1/holidaysList holidays (filter by year, state, type, status, month)
GET /v1/holidays/checkIs this date a holiday/weekend/working day/school day?
GET /v1/holidays/todayToday's holiday status
GET /v1/holidays/nextNext upcoming holiday
GET /v1/holidays/betweenHolidays in date range
GET /v1/holidays/leave-optimizerSuggest annual-leave days to spend for the longest consecutive break
GET /v1/business-daysCount business days between dates
GET /v1/business-days/addAdd N business days to a date
GET /v1/statesAll 16 states + 3 FTs with weekend config
GET /v1/states/resolveResolve alias (KL, penang, jb) to canonical code
GET /v1/school/termsSchool term dates + day counts
GET /v1/school/holidaysSchool holidays + KPM cuti perayaan
GET /v1/school/examsSPM, STPM, MUET, PT3 schedule
GET /v1/school/is-school-dayIs this a school day?
GET /v1/feed/ical/:stateiCal subscription feed
GET /v1/feed/csv/:stateCSV/spreadsheet export of holidays
GET /v1/data/*Raw, cacheable open-data snapshots β€” manifest, states, holidays/:year, all (no API key required)
GET /v1/prayer-times/:zoneJAKIM prayer times for a zone (MYT-formatted); GET /v1/prayer-times/zones lists the zone directory
POST /v1/keysIssue an API key (admin-gated for now; GET /v1/keys/whoami checks the caller's tier)

See the full OpenAPI 3.1 spec for request/response schemas.

SDK Usage

server.ts
import { MyCalClient } from "@catlabtech/mycal-sdk";

const cal = new MyCalClient();

// Check if a date is a working day
const result = await cal.check("2026-03-21", "selangor");
console.log(result.isWorkingDay); // false

// List holidays
const holidays = await cal.holidays({ year: 2026, state: "KL" });

// Business days
const workDays = await cal.businessDays("2026-03-01", "2026-03-31", "selangor");
console.log(workDays.businessDays); // 22

// School calendar
const terms = await cal.school.terms({ year: 2026, group: "B" });
const exams = await cal.school.exams({ year: 2026, type: "spm" });
const isSchool = await cal.school.isSchoolDay("2026-03-21", "selangor");

MCP Server

Connect the Malaysia Calendar API to Claude, ChatGPT, or any MCP-compatible AI assistant.

Setup with Claude Desktop / Claude Code

Add to your MCP configuration:

config.json
{
  "mcpServers": {
    "malaysia-calendar": {
      "command": "npx",
      "args": ["@catlabtech/mycal-mcp-server"]
    }
  }
}

Available Tools (13)

ToolDescription
get_malaysia_holidaysGet public holidays (filter by year, state, type)
check_malaysia_holidayCheck if a date is a holiday or working day
next_malaysia_holidayFind the next upcoming holiday
malaysia_business_daysCount working days between two dates
malaysia_long_weekendsFind long weekends (3+ days)
malaysia_leave_optimizerFind the most efficient leave days to take to maximise consecutive days off
list_malaysia_statesList all states with weekend config
resolve_malaysia_stateResolve alias (KL, JB) to canonical code
malaysia_holiday_changesRecent data changes
malaysia_school_termsSchool term dates and day counts
malaysia_school_holidaysSchool holidays (cuti penggal, cuti perayaan)
malaysia_examsSPM, STPM, MUET, PT3 exam schedule
malaysia_is_school_dayCheck if a date is a school day

State Codes

CodeAliasesGroupWeekend
johorjhr, jbBSat-Sun (was Fri-Sat 2014-2024)
kedahkd, kdhAFri-Sat
kelantankel, kbAFri-Sat
terengganutrg, ktAFri-Sat
perakprk, ipohBSat-Sun
pulau-pinangpenang, pgBSat-Sun
selangorsel, sgrBSat-Sun
negeri-sembilanns, n9BSat-Sun
melakamlk, malaccaBSat-Sun
pahangphg, kuantanBSat-Sun
perlispls, kangarBSat-Sun
sabahsbh, kkBSat-Sun
sarawakswk, kuchingBSat-Sun
kuala-lumpurklBSat-Sun
wp-putrajayaputrajaya, pjyBSat-Sun
wp-labuanlabuan, lbnBSat-Sun

State aliases are case-insensitive. Use GET /v1/states/resolve?q=kl to resolve any alias to the canonical code.

Project Structure

Read the full README β†’View source on GitHub β†’

Related MCP Servers

View all in Workplace & Productivity View all alternatives
  • Kaneo logoKaneo

    Official MCP server for Kaneo: manage tasks, projects, and labels from Claude and other MCP clients

    🏒 Workplace & Productivity0 views
    Compare vs Kaneo β†’
  • Hackmd MCP logoHackmd MCP

    Allows AI models to interact with HackMD

    🏒 Workplace & Productivity2 views
    Compare vs Hackmd MCP β†’
  • Excel MCP Server logoExcel MCP Server

    An Excel manipulation server providing workbook creation, data operations, formatting, and advanced features (charts, pivot tables, formulae).

    🏒 Workplace & Productivity6 views
    Compare vs Excel MCP Server β†’
  • MCP Kibela Server logoMCP Kibela Server

    MCP server implementation for Kibela API integration

    🏒 Workplace & Productivity3 views
    Compare vs MCP Kibela Server β†’

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks β€” not a rating.

GitHub stars
3
Stargazers on the source repository.
npm downloads
76M
Package downloads in the last 30 days.
Last commit
2mo ago
Most recent push to the default branch.
Tools exposed
13
Callable tools this server registers over MCP.

Reviews

No reviews yet β€” be the first to share how this listing worked for you.

Frequently Asked Questions about Mycal

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "mycal": { "command": "npx", "args": ["@catlabtech/mycal-mcp-server"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMycal AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/mycal?style=directory)](https://allmcps.com/mcp/mycal)
HTML Embed
<a href="https://allmcps.com/mcp/mycal"><img src="https://allmcps.com/api/badge/mycal?style=directory" alt="Mycal on AllMCPs" /></a>

Technical Specs & Signals

Category🏒Workplace & Productivity
More technical detailsExpand β–Ύ
TransportSTDIO
RuntimeNode.js
Last updatedJul 6, 2026
2/7 checks healthy over the last 45d
Views0
Unique ViewsTotal visits recorded for this listing page on AllMCPs.
Installs0
Installs & Copy ActionsTotal times users copied install commands or configuration snippets for this server.
GitHub stars3
GitHub Star CountTotal stargazers on GitHub representing community popularity (3 stars).
Last commit2mo ago
Last Repository CommitThe most recent commit or push recorded for this server's GitHub repository.Last commit on Jul 6, 2026
npm downloads76,314,697/mo
Monthly npm DownloadsAverage monthly package installs recorded from npm registry statistics.
56Quality signal: Good Β· 56/100How this signal is calculated β–Ύ
Server availabilityNot measured

Not scored for repo-hosted servers β€” we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20
Documentation & tools25/30
Adoption & activity7/15
Community engagement0/10

A guidance signal from public completeness & health data β€” not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 2d ago via OSV.dev Β· @catlabtech/mycal-mcp-server (npm)

β˜… FeaturedAllMCPs Server logo

AllMCPs Server

The official MCP server for AllMCPs.com - submit and manage tools directly from your AI. The open directory for MCP servers. Connect Claude, Cursor, Windsurf, and AI agents to databases, tools, files, and APIs. Explore 10,000+ servers. AllMCPs is the premier, open directory for discovering, evaluating, and installing Model Context Protocol (MCP) servers to equip AI agents and LLMs with real-world superpowers.

Explore Server β†’

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge β€” proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it β€” no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🏒 Workplace & Productivity β†’Best MCP servers for Workplace & Productivity β†’Alternatives to Mycal β†’Install in Claude DesktopInstall in CursorInstall in VS CodeSetup guides for all 13 MCP clients