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.
01 · SETUP
Setup
Select an assistant, copy what is shown, and add it there. Setup is done once.
Claude (web, desktop, and mobile)
- Open Settings, then Connectors.
- Select “Add custom connector”.
- Enter the name Zmanim and the URL below, then select Add.
https://zmanim.kavana-ai.workers.dev/mcpThe connector is then available in every Claude conversation on the account, including the mobile apps.
ChatGPT
- Open Settings, then Apps & Connectors.
- Under Advanced settings, turn on Developer mode. Custom connectors are unavailable without it.
- Select Create, enter the name Zmanim and the URL below, and set authentication to “No authentication”.
https://zmanim.kavana-ai.workers.dev/mcpDeveloper mode is limited to certain ChatGPT plans, and the menu names change between releases.
Meta Muse
- Open Muse and send the prompt below.
- If Muse asks, the transport is HTTP and the authentication is none.
- 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/mcpCursor
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/mcpAgents 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.
| Tool | Returns | Parameters |
|---|---|---|
get_zmanim | Thirteen 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_times | Candle-lighting and Havdalah for the coming Shabbat, the parasha, and holidays on that Friday and Saturday. | place, date, candle_minutes, havdalah_minutes |
get_hebrew_date | The 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_date | The civil date of a Hebrew date, and the evening on which it begins. | day, month, year (all required) |
list_prayers | The prayers whose text is available, grouped by service, for one tradition. | tradition (sephardic, ashkenaz, sefard) |
get_service | A 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_prayer | The 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_psalm | One chapter of Tehillim in Hebrew with vowels and in English (JPS 1917). | chapter (required, 1 to 150), include_english |
find_blessing | The 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 | Default | Other values |
|---|---|---|
dawn | ovadia: alot 72 seasonal minutes before sunrise, misheyakir 66 seasonal minutes before sunrise | posen (16.1° and 11°), chabad (16.9° and 10.2°), fixed72 (72 clock minutes and 11.5°) |
nightfall | 8.5deg: sun 8.5° below the horizon | 7.083deg, 6deg, 13.5min (13.5 seasonal minutes after sunset) |
candle_minutes | 18 minutes before Friday’s sunset | 0 to 90 |
havdalah_minutes | 40 minutes after Saturday’s sunset | 0 to 120; 0 selects the sun 8.5° below the horizon |
elevation_meters | 0 | 0 to 9000; changes sunrise and sunset only |
israel | false (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):
| Time | Value | Rule |
|---|---|---|
| Alot HaShachar | 05:01 | 72 seasonal minutes before sunrise |
| Netz HaChamah | 06:12 | Calculated sunrise |
| Sof zman Shema (GRA) | 09:06 | 3 seasonal hours from sunrise |
| Chatzot | 12:03 | Midpoint between sunrise and sunset |
| Shkiah | 17:54 | Calculated sunset |
| Tzeit HaKochavim | 18:27 | Sun 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.