← Daily prayer times

FOR AI AGENTS

Zmanim MCP server

A public MCP server that gives AI assistants calculated zmanim, Shabbat times, and Hebrew calendar data, and the text of prayers, Psalms, and blessings. No account or API key is required.

Transport: Streamable HTTPAuthentication: noneLimit: 60 requests per minuteSource: open (GPL-2.0-or-later)

01 · SETUP

Setup

Select an assistant, copy what is shown, and add it there. Setup is done once.

Claude (web, desktop, and mobile)

  1. Open Settings, then Connectors.
  2. Select “Add custom connector”.
  3. Enter the name Zmanim and the URL below, then select Add.
https://zmanim.kavana-ai.workers.dev/mcp

The connector is then available in every Claude conversation on the account, including the mobile apps.

ChatGPT

  1. Open Settings, then Apps & Connectors.
  2. Under Advanced settings, turn on Developer mode. Custom connectors are unavailable without it.
  3. Select Create, enter the name Zmanim and the URL below, and set authentication to “No authentication”.
https://zmanim.kavana-ai.workers.dev/mcp

Developer mode is limited to certain ChatGPT plans, and the menu names change between releases.

Meta Muse

  1. Open Muse and send the prompt below.
  2. If Muse asks, the transport is HTTP and the authentication is none.
  3. Confirm that Muse saved the integration as a skill, then test it in a new conversation.
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 for zmanim, Shabbat times, the Hebrew calendar, prayer texts, Psalms, and blessings. 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.

Muse builds custom integrations from a chat instruction and has no settings screen for them. These steps follow third-party guides and were not tested for this page.

Coding tools

Claude Code

claude mcp add --transport http --scope user zmanim https://zmanim.kavana-ai.workers.dev/mcp

Cursor

Add to Cursor

GitHub Copilot in VS Code

code --add-mcp '{"name": "zmanim", "type": "http", "url": "https://zmanim.kavana-ai.workers.dev/mcp"}'

Other assistants and agents

Any client that supports MCP over Streamable HTTP can use the endpoint URL, with no authentication.

https://zmanim.kavana-ai.workers.dev/mcp

Agents that connect through a chat instruction, such as Claude Duet or Dot, can be sent this prompt. It was not tested with those agents.

Connect to the Zmanim MCP server at https://zmanim.kavana-ai.workers.dev/mcp. It is a remote MCP server over streamable HTTP and needs no authentication. It has four tools: get_zmanim, get_shabbat_times, get_hebrew_date, and convert_hebrew_date. Test each tool, show me the results, and keep the connection available in future conversations.

Product names and logos belong to their respective owners and are shown to identify compatible software. Kavaná is not affiliated with or endorsed by these companies.

Weekly Shabbat reminder

After setup, an assistant that supports scheduled tasks can send the times every Friday. Enter a city and send this prompt.

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.

02 · REFERENCE

Technical reference

Endpoint, tools, parameters, defaults, an example request, and limitations.

Endpoint

https://zmanim.kavana-ai.workers.dev/mcp

The server is stateless. Each request is a JSON-RPC message sent with HTTP POST, and the response is JSON. There are no sessions and no server-initiated streams, so GET returns 405. Cross-origin requests are allowed.

Tools and parameters

A place is given either as location (a city name, optionally with a country or region) or as latitude, longitude, and an IANA timezone. Dates use the form YYYY-MM-DD and default to the current day at that place. All parameters other than the place are optional unless noted.

Tools exposed by the server
ToolReturnsParameters
get_zmanimThirteen times for one day: alot, misheyakir, sunrise, latest Shema and tefillah (GRA and MGA), chatzot, mincha gedolah, mincha ketanah, plag, sunset, and nightfall. Each entry includes the rule used.place, date, dawn, nightfall, elevation_meters
get_shabbat_timesCandle-lighting and Havdalah for the coming Shabbat, the parasha, and holidays on that Friday and Saturday.place, date, candle_minutes, havdalah_minutes
get_hebrew_dateThe Hebrew date of a civil date, holidays, fasts, Rosh Chodesh and omer count on that date, the week’s parasha, and optionally the following days.date, timezone, after_sunset, israel, days_ahead (0 to 400)
convert_hebrew_dateThe civil date of a Hebrew date, and the evening on which it begins.day, month, year (all required)
list_prayersThe prayers whose text is available, grouped by service, for one tradition.tradition (sephardic, ashkenaz, sefard)
get_serviceA whole service (Shacharit, Mincha, or Arvit) in printed order for a given day, with the list of its prayers. The day selects the service: Shabbat morning on Saturday, Kabbalat Shabbat on Friday night. Notes list the usual changes for Rosh Chodesh, Chanukah, Purim, fast days, and festivals.service (required), date, timezone, tradition, israel, position, include_english
get_prayerThe Hebrew text of a prayer, with English where the source provides it. Long prayers are returned in parts of about 7,000 characters.prayer (required), service, tradition, offset, include_english
get_psalmOne chapter of Tehillim in Hebrew with vowels and in English (JPS 1917).chapter (required, 1 to 150), include_english
find_blessingThe blessing before and after a food or drink, in Hebrew with transliteration and English, from a guide of 40 common foods following Sephardic practice.food (English or Spanish; omit to list every blessing)

Calculation defaults and options

The solar model is the NOAA/Meeus method described under calculation methods. The defaults below are those of the Kavaná app. Every response states the method that was applied.

Parameter values · sea-level horizon unless an elevation is given
ParameterDefaultOther values
dawnovadia: alot 72 seasonal minutes before sunrise, misheyakir 66 seasonal minutes before sunriseposen (16.1° and 11°), chabad (16.9° and 10.2°), fixed72 (72 clock minutes and 11.5°)
nightfall8.5deg: sun 8.5° below the horizon7.083deg, 6deg, 13.5min (13.5 seasonal minutes after sunset)
candle_minutes18 minutes before Friday’s sunset0 to 90
havdalah_minutes40 minutes after Saturday’s sunset0 to 120; 0 selects the sun 8.5° below the horizon
elevation_meters00 to 9000; changes sunrise and sunset only
israelfalse (diaspora calendar)true (one-day festivals, Israel reading schedule)

One seasonal minute is the time from sunrise to sunset divided by 720. The MGA day runs from alot to the matching evening time of the selected dawn method. Displayed deadlines (latest Shema, latest tefillah, sunset, candle-lighting) are rounded down to the minute; all other times are rounded up.

Example request and response

curl -s https://zmanim.kavana-ai.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_zmanim",
       "arguments":{"location":"Panama City, Panama","date":"2026-11-15"}}}'

The result is a JSON document. Selected fields for this request (8.9936° N, 79.5197° W, America/Panama, default methods):

Panama City · 15 November 2026 · 5 Kislev 5787
TimeValueRule
Alot HaShachar05:0172 seasonal minutes before sunrise
Netz HaChamah06:12Calculated sunrise
Sof zman Shema (GRA)09:063 seasonal hours from sunrise
Chatzot12:03Midpoint between sunrise and sunset
Shkiah17:54Calculated sunset
Tzeit HaKochavim18:27Sun 8.5° below the horizon

One seasonal hour on that day is 58.6 minutes.

Limitations and data handling

Sunrise and sunset agree with the @hebcal/core implementation of the same NOAA equations to within 60 seconds for six cities on six dates in 2026 (Panama City, Jerusalem, New York, Sydney, London, Honolulu). Terrain and local obstructions are not modeled. Where the sun does not rise and set on a date, or does not reach a required angle, the affected times are reported as unavailable.

Prayer texts come from Sefaria: Siddur Edot HaMizrach (Hebrew and English, CC0) for the Sephardic tradition, and the Metsudah siddur (1981, Avrohom Davis, CC BY) with public-domain texts for Ashkenaz and Nusach Sefard. Psalms use Tanach with Nikkud and the JPS 1917 translation (public domain). Texts follow the printed source and are not adjusted for the day; additions for particular days appear with their instructions. A food that is not in the blessings guide returns no blessing.

Holidays and Torah readings are computed by @hebcal/core. Entries named “Erev …” or “Chanukah: N Candles” are listed on the civil date whose evening begins them.

City names are matched against a list of about 34,000 cities built into the server (data from GeoNames, CC BY 4.0), so the server contacts no other service. A place outside the list can be given as coordinates and a time zone. The server does not write requests to storage. Requests are limited to 60 per minute per client address and 64 KB per request.

The server is open source under GPL-2.0-or-later. Source code, tests, and instructions for running a private copy: github.com/jonyteubal/zmanim-mcp.

Results are calculations, not halachic rulings. The applicable method and local practice should be confirmed with a community luach or a rabbi.