Mycal MCP Server

Malaysia's most complete calendar API - public holidays, school calendar, exam schedules, and MCP server for AI tools. Its 13 documented tools cover malaysia, holiday, school, holidays. It runs locally over stdio via the published package.

People connecting productivity tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-07-06 · ★ 3 · #84 OF 139 MAINTAINED PRODUCTIVITY · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Mycal

before you install - you'll need

The README does not document required environment variables for a basic install.

Claude Code

claude mcp add junhui20-malaysia-calendar-api -- npx -y @catlabtech/mycal-mcp-server

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "junhui20-malaysia-calendar-api": {
      "command": "npx",
      "args": [
        "-y",
        "@catlabtech/mycal-mcp-server"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @catlabtech/mycal-mcp-server - the @catlabtech scope differs from the repo owner (junhui20); confirm it's the project's official package

registry namespace io.github.Junhui20 is GitHub-verified and matches the repo owner

03 · What Mycal can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can get public holidays (filter by year, state, type), check if a date is a holiday or working day, find the next upcoming holiday, and count working days between two dates.

Capability map

Tools grouped from the project's README - what Mycal lets an agent do.

Malaysia

8 tools - e.g. Count working days between two dates; Find long weekends (3+ days); Find the most efficient leave days to take to maximise consecutive days off

malaysia_business_days · malaysia_long_weekends · malaysia_leave_optimizer · malaysia_holiday_changes · malaysia_school_terms · malaysia_school_holidays…

read & search

2 tools - e.g. Get public holidays (filter by year, state, type); List all states with weekend config

get_malaysia_holidays · list_malaysia_states

Check

1 tool - e.g. Check if a date is a holiday or working day

check_malaysia_holiday

1 tool - e.g. Find the next upcoming holiday

next_malaysia_holiday

Resolve

1 tool - e.g. Resolve alias (KL, JB) to canonical code

resolve_malaysia_state

04 · Who maintains Mycal

mycal is maintained by junhui20. It's the only MCP server we track from this author; the repo dates to Mar 2026.

05 · Facts

repository: github.com/junhui20/malaysia-calendar-api
category: productivity - ranked #84 of 139 actively-maintained productivity servers as of 2026-08-25.
registry: io.github.Junhui20/mycal (active, first published 2026-06-28)
packages: npm:@catlabtech/mycal-mcp-server

06 · Mycal FAQ

Is Mycal still maintained?

Yes - as of 2026-08-25, its last commit was 2026-07-06. We re-verify nightly.

What can Mycal do?

How do I install Mycal?

Run `npx -y @catlabtech/mycal-mcp-server`. The README does not document required environment variables for a basic install. You can also paste the ready-made client config above.

Does Mycal run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Mycal

Alternatives to Mycal

Maintained productivity servers if Mycal isn't the fit.

Pairs well with

Servers that cover what Mycal doesn't - only shown when the pairing reason fits the companion.

More productivity MCP servers · Obsidian Everywhere · Agent Tasks · Notipo · macOS Calendar & Reminders · Kolonie AI

More TypeScript MCP servers · Amazon.in MCP Server · Accessibility Scanner · Gongio MCP · Linkinator MCP · see all