Skip to main content
Glama
zmanim-mcp

zmanim-mcp

by jonyteubal

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/mcp

No 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/mcp

The 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

get_zmanim

The 13 zmanim for a date and place, each with the rule behind it

get_shabbat_times

Candle-lighting, Havdalah, parasha, holidays on that Shabbat

get_hebrew_date

Hebrew date, what falls on it, parasha, upcoming holidays

convert_hebrew_date

Civil date of a Hebrew date (birthdays, yahrzeits)

list_prayers

The prayers available, by service, for one tradition

get_service

A whole service (Shacharit, Mincha, Arvit) in order for a given day

get_prayer

Hebrew text of a prayer, with English where the source has it

get_psalm

A chapter of Tehillim in Hebrew and English

find_blessing

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, fixed72 available)

  • Nightfall: sun 8.5° below the horizon (7.083deg, 6deg, 13.5min available)

  • 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 server

Add 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 deploy

Layout

File

Purpose

src/solar.ts

NOAA solar equations: sunrise, sunset, sun-angle times

src/zmanim.ts

Zmanim and Shabbat times from those solar events

src/calendar.ts

Hebrew dates, holidays and parasha via @hebcal/core

src/location.ts

City lookup in the built-in list, time zone validation

data/cities.txt

City names, coordinates and time zones from GeoNames

src/texts.ts

Prayer, Psalm and blessing lookups

assets/texts/

One JSON file per prayer, built by scripts/build_texts.py

src/server.ts

The nine MCP tools

src/index.ts

Local stdio entry point

src/worker.ts

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…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides 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.
      3
      33 npm
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides 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.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to access and query the Sefaria digital library of Jewish texts through natural language or direct tool calls.
      302 npm
      1
      MIT