zmanim-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
zmanim-mcp
A Model Context Protocol (MCP) server that gives AI assistants calculated zmanim, Shabbat times and Hebrew calendar data, plus the text of the siddur, Tehillim, and the blessings for foods. It uses the same solar and zmanim calculations as the Kavaná siddur app. There is no AI in the server: every answer is deterministic math.
Public endpoint
https://zmanim.kavana-ai.workers.dev/mcpNo account or API key. Setup steps for Claude, ChatGPT, Claude Code, Cursor and GitHub Copilot are at https://kavana.jonyy.com/mcp/. The short version for Claude Code:
claude mcp add --transport http zmanim https://zmanim.kavana-ai.workers.dev/mcpThe endpoint is stateless Streamable HTTP (POST only), limited to 60 requests a minute per client address.
Related MCP server: Vreme Temporal MCP
Meta Muse and other personal agents
Muse builds custom integrations from a chat instruction. Send it this prompt (based on third-party guides, not tested against Muse):
Build a custom integration to the Zmanim MCP server at https://zmanim.kavana-ai.workers.dev/mcp. Use the official MCP SDK with the Streamable HTTP client transport. The server is stateless: every call is an HTTP POST of a JSON-RPC message, with no sessions, no GET or server-sent streams, and no authentication or credentials. Call tools/list to see its nine read-only tools. Test get_shabbat_times with {"location":"Miami"} and find_blessing with {"food":"banana"}, show me the results, and save the integration as a reusable skill so I can use it from any future conversation.
Other agents that connect through chat (Claude Duet, Dot and similar) can be given the endpoint URL with the same description.
Weekly Shabbat reminder
In an assistant that supports scheduled tasks, send this after setup (replace the city):
Create a recurring task for every Friday at 9:00 AM in my time zone. Each time it runs, call the get_shabbat_times tool of the zmanim MCP server for [your city] and send me four lines: the candle-lighting time, the Havdalah time, the parasha, and any holiday on that Shabbat. State the candle-lighting and Havdalah offsets that were used. If the server cannot be reached, say so and do not estimate the times.
Tools
Tool | Answers |
| The 13 zmanim for a date and place, each with the rule behind it |
| Candle-lighting, Havdalah, parasha, holidays on that Shabbat |
| Hebrew date, what falls on it, parasha, upcoming holidays |
| Civil date of a Hebrew date (birthdays, yahrzeits) |
| The prayers available, by service, for one tradition |
| A whole service (Shacharit, Mincha, Arvit) in order for a given day |
| Hebrew text of a prayer, with English where the source has it |
| A chapter of Tehillim in Hebrew and English |
| The blessing before and after a food or drink |
A place is a city name ("Panama City, Panama") or latitude, longitude and an
IANA timezone. City names are matched against a built-in list of about 34,000
cities (data/cities.txt), so the server contacts no outside service.
Defaults
Dawn: Rav Ovadia Yosef, 72 seasonal minutes (
posen,chabad,fixed72available)Nightfall: sun 8.5° below the horizon (
7.083deg,6deg,13.5minavailable)Candle-lighting: 18 minutes before sunset. Havdalah: 40 minutes after
Deadlines round down to the minute, beginnings round up
Sea-level horizon unless an elevation is given. Terrain is not modeled
Every response states the method used. The equations are documented at https://kavana.jonyy.com/calculations/.
Run it yourself
Requires Node.js 20 or later.
npm install
npm test # builds, then runs the test suite
npm start # local stdio serverAdd the local server to Claude Code:
claude mcp add zmanim -- node "$PWD/dist/index.js"Deploy your own copy to Cloudflare Workers:
npm run dev # local HTTP server on http://localhost:8787/mcp
npm run deployLayout
File | Purpose |
| NOAA solar equations: sunrise, sunset, sun-angle times |
| Zmanim and Shabbat times from those solar events |
| Hebrew dates, holidays and parasha via |
| City lookup in the built-in list, time zone validation |
| City names, coordinates and time zones from GeoNames |
| Prayer, Psalm and blessing lookups |
| One JSON file per prayer, built by |
| The nine MCP tools |
| Local stdio entry point |
| Cloudflare Workers entry point (public HTTP endpoint) |
The tests check sunrise and sunset against @hebcal/core's independent
implementation to within 60 seconds across six cities and six dates.
Disclaimer
Results are calculations, not halachic rulings. Confirm the applicable method and local practice with a community luach or a rabbi.
Credits
Hebrew calendar: @hebcal/core (GPL-2.0-or-later)
City list: GeoNames (CC BY 4.0)
Sephardic siddur: Siddur Edot HaMizrach via Sefaria, Hebrew Shaliehsaboo Edition (CC0), English Sefaria Community Translation (CC0)
Ashkenaz and Nusach Sefard siddurim: via Sefaria. Hebrew and English from the Metsudah siddur (1981), Avrohom Davis (CC BY), with public-domain texts for missing sections
Tehillim: Tanach with Nikkud; English, The Holy Scriptures (JPS 1917), public domain
Solar equations: NOAA Solar Calculator, after Jean Meeus, Astronomical Algorithms
License
GPL-2.0-or-later. See LICENSE. The Hebrew calendar dependency,
@hebcal/core, is under the same license.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Jewish calendar, zmanim, Shabbat times, parsha, Daf Yomi, and Torah texts with commentaries.
Ground truth for Jewish life: kosher checks, places, menus, providers, events, Shabbat times.
Live Israeli public data for AI agents: alerts, prices, open data, FX rates, Shabbat times.
Public holiday data for 30+ countries. Check holidays, working days and calendars via AI assistants.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables Large Language Models to retrieve Jewish texts and commentaries from the Sefaria library through a standardized interface.21MIT
- AlicenseAqualityDmaintenanceProvides AI assistants with rich temporal intelligence including timezone conversions, 9 cultural calendars (Hebrew, Islamic, Chinese, etc.), astronomical events, Islamic prayer times, and context-aware activity appropriateness recommendations.333 npmMIT
- FlicenseNot gradedqualityDmaintenanceProvides access to Jewish holiday calendars and Shabbat candle lighting and Havdalah times for various cities via the Hebcal API. It enables users to query specific holiday dates and weekly Shabbat schedules through natural language.-
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to access and query the Sefaria digital library of Jewish texts through natural language or direct tool calls.302 npm1MIT