Islamic Calendar MCP
MCP server providing JAKIM Hijri calendar data and tools for lunar months and Islamic events in Malaysia.
README
Hijri Calendar
A remote MCP server for the Malaysian Islamic (Hijri) calendar.
It helps AI tools look up Hijri months, Gregorian dates, and important Islamic dates in Malaysia — such as Awal Ramadan, Aidilfitri, Aidiladha, Maal Hijrah, and Maulidur Rasul.
Connect
https://hijri.shahrulestar.com/mcp
What it covers
- Hijri lunar months (1447H–1450H; 1450H through Sha’ban only)
- Day-by-day Hijri takwim (2025–2028 Gregorian, Asia/Kuala_Lumpur)
- Important Islamic dates and observances in Malaysia
- Matching Hijri and Gregorian (Miladi) dates
Tools
| Tool | What it does |
|---|---|
get_lunar_months |
Month summary. Start, end, and length of each Hijri month. Use for “when is Ramadan?” or which month covers a Gregorian date. |
get_hijri_calendar |
Day-by-day takwim. Hijri date and weekday for one day, a Hijri month, or a short Gregorian range. |
get_islamic_events |
Observances in Malaysia. Aidilfitri, Aidiladha, Maulid, Awal Ramadan, and other important Islamic dates. |
Data
Calendar files are split by Gregorian year under data/takwim/:
| File | Contents |
|---|---|
meta.json |
Timezone, month-name dictionaries, Hijri year summaries, Islamic event templates, recurring observances |
2025.json–2028.json |
Day-by-day takwim and lunar months |
A Hijri month that spans New Year is stored in the year it starts (for example Sha’ban 1449H lives in 2027.json). The MCP tools merge all years in memory, so lookups by Hijri year still work.
Calendar data follows Malaysia timezone (Asia/Kuala_Lumpur) and is verified against JAKIM’s official Islamic calendar (e-Solat):
Islamic events are stored once as Hijri month+day templates and resolved to Gregorian dates from the lunar month table. This server never advances an event earlier than its Hijri day on that table.
Sponsor
If this calendar is useful, you can sponsor the project on GitHub.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.