Zmanim MCP Server
This server calculates Jewish prayer times (zmanim) for any location worldwide using accurate NOAA-based astronomical calculations, supporting multiple halachic opinions and flexible output formats.
Core Capabilities:
Sunrise & Sunset Times — Calculate precise sunrise and sunset for any geographic location and date.
Latest Shema Times — Retrieve the morning Shema deadline per GR"A (3 temporal hours after sunrise) and MG"A (3 temporal hours from dawn).
Latest Morning Prayer Times — Calculate the Shacharis cutoff per GR"A (4 hours after sunrise) and MG"A (4 temporal hours from dawn).
Mincha Prayer Times — Get Mincha Gedola (earliest, 30 min after midday), Mincha Ketana (2.5 hours before sunset), and Plag HaMincha (1.25 hours before sunset).
Shabbat Times — Calculate candle lighting (customizable offset, default 18 min before sunset), sunset, and Havdalah (72 minutes after sunset).
All Daily Zmanim — A comprehensive daily schedule including Alos HaShachar (dawn), sunrise, Shema, Tefila, Chatzos (solar noon), all Mincha times, sunset, and nightfall.
Additional Features:
Accepts any global location via latitude/longitude and IANA timezone
Optional date input (defaults to today)
Output in Markdown (human-readable) or JSON (machine-readable) format
Gracefully handles edge cases like polar locations (returns "N/A")
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Zmanim MCP Server Get Shabbat candle lighting times for Jerusalem this Friday."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Zmanim MCP Server
A comprehensive MCP server for calculating Jewish prayer times (zmanim).
A comprehensive Model Context Protocol (MCP) server for calculating Jewish prayer times (zmanim) using the python-zmanim library.
Overview
This MCP server provides tools to calculate various Jewish prayer times and astronomical times for any location worldwide. It uses the python-zmanim library, which is a Python port of the KosherJava project, implementing accurate astronomical calculations based on the NOAA algorithm.
Related MCP server: MCP Node Time
Features
Available Tools
zmanim_get_sunrise_sunset - Get sunrise and sunset times
zmanim_get_shema_times - Get latest times for reciting the morning Shema (GR"A and MG"A opinions)
zmanim_get_tefila_times - Get latest times for morning prayer/Shacharis (GR"A and MG"A opinions)
zmanim_get_mincha_times - Get times for afternoon prayer including Mincha Gedola, Mincha Ketana, and Plag HaMincha
zmanim_get_shabbat_times - Get Shabbat candle lighting and Havdalah times
zmanim_get_daily_times - Get a comprehensive set of all daily zmanim
Key Features
✅ Support for multiple halachic opinions (GR"A, MG"A)
✅ Accurate NOAA-based astronomical calculations
✅ Support for any global location with latitude/longitude
✅ Timezone-aware calculations
✅ Optional date specification (defaults to today)
✅ Multiple output formats (Markdown and JSON)
✅ Customizable candle lighting offset
✅ Comprehensive error handling
Installation
Via PyPI (Recommended)
# For use with Claude Desktop or other MCP clients
uvx zmanim-mcp-serverClaude Desktop Configuration
Add to your claude_desktop_config.json:
{
"mcpServers": {
"zmanim": {
"command": "uvx",
"args": ["zmanim-mcp-server"]
}
}
}Usage Examples
Get Sunrise and Sunset
Get sunrise and sunset times for New York City today:
- Location: New York, NY
- Latitude: 40.7128
- Longitude: -74.0060
- Time Zone: America/New_YorkGet Latest Shema Times
What time is the latest I can say Shema in Jerusalem?
- Location: Jerusalem
- Latitude: 31.7683
- Longitude: 35.2137
- Time Zone: Asia/JerusalemGet Shabbat Times
Get Shabbat candle lighting and Havdalah times for Chicago this Friday:
- Location: Chicago, IL
- Latitude: 41.8781
- Longitude: -87.6298
- Time Zone: America/Chicago
- Candle lighting offset: 18 minutes (can be customized)Get Complete Daily Schedule
Give me all the prayer times for London today:
- Location: London
- Latitude: 51.5074
- Longitude: -0.1278
- Time Zone: Europe/LondonZmanim Explained
Morning Times
Alos HaShachar (Dawn): First light, 72 minutes before sunrise
Sunrise (Hanetz HaChama): When the sun rises above the horizon
Sof Zman Krias Shema: Latest time to recite the morning Shema
GR"A: 3 hours after sunrise
MG"A: 3 temporal hours from dawn (typically earlier)
Sof Zman Tefila: Latest time for morning prayer (Shacharis)
GR"A: 4 hours after sunrise
MG"A: 4 temporal hours from dawn (typically earlier)
Afternoon Times
Chatzos: Solar noon, midpoint between sunrise and sunset
Mincha Gedola: Earliest time for afternoon prayer (30 minutes after midday)
Mincha Ketana: Preferred earliest time for Mincha (2.5 hours before sunset)
Plag HaMincha: 1.25 hours before sunset (latest time according to some opinions)
Evening Times
Sunset (Shkiah): When the sun sets below the horizon
Tzeis HaKochavim: Nightfall, when stars appear (72 minutes after sunset)
Shabbat & Holidays
Candle Lighting: Typically 18-40 minutes before sunset (varies by community)
Havdalah: When Shabbat ends, typically at Tzeis (72 minutes after sunset)
Halachic Opinions
The server supports calculations according to different halachic authorities:
GR"A (Vilna Gaon): Calculates day from sunrise to sunset
MG"A (Magen Avraham): Calculates day from dawn (72 minutes before sunrise) to nightfall
Response Formats
Markdown Format (default)
Human-readable format with clear headers and organized sections, perfect for display.
JSON Format
Machine-readable structured data including ISO 8601 timestamps, suitable for programmatic use.
Input Parameters
All tools accept the following parameters:
location (required): Name of the location (e.g., "New York, NY")
latitude (required): Latitude in decimal degrees (-90 to 90)
longitude (required): Longitude in decimal degrees (-180 to 180)
time_zone (required): IANA timezone identifier (e.g., "America/New_York")
date (optional): Date in YYYY-MM-DD format (defaults to today)
response_format (optional): "markdown" or "json" (defaults to markdown)
For Shabbat times, there's an additional parameter:
candle_lighting_offset (optional): Minutes before sunset (1-60, default 18)
Technical Details
Calculations
Uses the NOAA (National Oceanic and Atmospheric Administration) algorithm
Accounts for atmospheric refraction
Timezone-aware using IANA timezone database
Elevation can be incorporated in calculations
Dependencies
fastmcp: Standalone FastMCP framework
zmanim: Python port of KosherJava zmanim library
pydantic: Input validation and data modeling
Common Location Examples
Location | Latitude | Longitude | Timezone |
Jerusalem | 31.7683 | 35.2137 | Asia/Jerusalem |
New York | 40.7128 | -74.0060 | America/New_York |
Los Angeles | 34.0522 | -118.2437 | America/Los_Angeles |
London | 51.5074 | -0.1278 | Europe/London |
Paris | 48.8566 | 2.3522 | Europe/Paris |
Sydney | -33.8688 | 151.2093 | Australia/Sydney |
Toronto | 43.6532 | -79.3832 | America/Toronto |
Miami | 25.7617 | -80.1918 | America/New_York |
Troubleshooting
Server not appearing in MCP client
Check that the path in your configuration is correct
Ensure Python and all dependencies are installed
Verify the configuration file syntax is valid JSON
Restart your MCP client after configuration changes
Times showing as "N/A"
This typically occurs for locations near the poles where the sun doesn't rise or set on certain days. The calculations handle this gracefully by returning "N/A".
Timezone errors
Ensure you're using valid IANA timezone identifiers. You can find a list at: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
License
This MCP server uses the python-zmanim library, which is licensed under the GNU Lesser General Public License v2 or later (LGPLv2+), ported from the KosherJava project.
Credits
Based on the python-zmanim library by pinnymz
Original Java library: KosherJava by Eliyahu Hershfeld
NOAA astronomical calculations
Support
For issues related to:
This MCP server: Please open an issue with details about your configuration and the problem
Zmanim calculations: Refer to the python-zmanim repository
Halachic questions: Consult your local rabbi or posek
Future Enhancements
Potential additions to consider:
Hebrew date calculations
Fast day times
Molad calculations
Holiday determination
Custom opinion configurations
Multi-day range queries
Export to calendar formats (iCal)
Note: This server is for informational purposes. For practical halachic decisions, please consult a qualified rabbi.
Available Tools
6 toolszmanim_get_daily_timesARead-onlyIdempotent
Get a comprehensive set of daily zmanim (Jewish prayer times) for a location.
This tool provides all major zmanim for the day including:
Alos HaShachar (dawn)
Sunrise
Latest times for Shema (GR"A and MG"A)
Latest times for Tefila (GR"A and MG"A)
Chatzos (midday)
Mincha times
Sunset
Tzeis HaKochavim (nightfall)
Args: params (LocationInput): Input parameters containing location and date information
Returns: str: Complete set of daily zmanim in the requested format
Example: Use this tool to get a complete daily schedule of prayer times for any location.
Inputs: params (required). Returns: result
zmanim_get_mincha_timesARead-onlyIdempotent
Get the times for Mincha (afternoon prayer) including Mincha Gedola and Mincha Ketana.
This tool calculates when the afternoon prayer can be recited:
Mincha Gedola: Earliest time (30 minutes after midday/chatzos)
Mincha Ketana: Preferred earliest time (2.5 hours before sunset)
Plag HaMincha: Latest time according to some opinions (1.25 hours before sunset)
Args: params (LocationInput): Input parameters containing location and date information
Returns: str: All relevant Mincha times in the requested format
Inputs: params (required). Returns: result
zmanim_get_shabbat_timesARead-onlyIdempotent
Get Shabbat candle lighting and Havdalah times for a specified location and date.
This tool calculates:
Candle lighting time (before sunset, typically 18-40 minutes depending on custom)
Sunset time (when Shabbat begins)
Tzeis HaKochavim (nightfall, when Shabbat ends, 72 minutes after sunset)
Args: params (CandleLightingInput): Input parameters including: - location, latitude, longitude, time_zone, date (from LocationInput) - candle_lighting_offset: Minutes before sunset (default 18)
Returns: str: Shabbat times in the requested format
Note: Different communities have different customs for candle lighting time. Jerusalem uses 40 minutes, while many communities use 18 minutes.
Inputs: params (required). Returns: result
zmanim_get_shema_timesARead-onlyIdempotent
Get the latest times for reciting the morning Shema according to different opinions.
This tool calculates the deadline for reciting the morning Shema (Krias Shema) according to two major halachic opinions: the GR"A (Vilna Gaon) and the Magen Avraham (MG"A). The GR"A calculation is 3 hours after sunrise, while the MG"A is based on 3 temporal hours from dawn (72 minutes before sunrise).
Args: params (LocationInput): Input parameters containing location and date information
Returns: str: Latest times for Shema according to both opinions in the requested format
Note: The MG"A time is typically earlier and more stringent than the GR"A time.
Inputs: params (required). Returns: result
zmanim_get_sunrise_sunsetARead-onlyIdempotent
Get sunrise and sunset times for a specified location and date.
This tool calculates the times of sunrise and sunset based on astronomical calculations, taking into account the geographic location. The calculations use the NOAA algorithm for accuracy.
Args: params (LocationInput): Input parameters containing: - location (str): Name of the location - latitude (float): Latitude in decimal degrees (-90 to 90) - longitude (float): Longitude in decimal degrees (-180 to 180) - time_zone (str): IANA timezone identifier - date (Optional[str]): Date in YYYY-MM-DD format (defaults to today) - response_format (ResponseFormat): 'markdown' or 'json'
Returns: str: Formatted sunrise and sunset times in the requested format
Example: For New York on a winter day, sunrise might be at 7:15 AM and sunset at 4:30 PM.
Inputs: params (required). Returns: result
zmanim_get_tefila_timesARead-onlyIdempotent
Get the latest times for morning prayer (Tefila/Shacharis) according to different opinions.
This tool calculates the deadline for reciting the morning Shemoneh Esrei according to two major halachic opinions: the GR"A (4 hours after sunrise) and the MG"A (4 temporal hours from dawn).
Args: params (LocationInput): Input parameters containing location and date information
Returns: str: Latest times for Tefila according to both opinions in the requested format
Inputs: params (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Tools are mostly distinct, with each focusing on specific prayer times (Mincha, Shabbat, Shema, etc.). However, the comprehensive 'daily_times' tool subsumes many of the others, potentially causing an agent to select it instead of a more specific tool.
All tools follow a consistent 'zmanim_get_<descriptive_noun>' pattern in snake_case. This makes it easy for an agent to understand the purpose and predict tool names.
Six tools cover the major categories of Jewish daily prayer times (general, Mincha, Shabbat, Shema, sunrise/sunset, Tefila) without being excessive or sparse. The count is well-scoped for this domain.
The set covers most core daily zmanim needs. However, it lacks tools for holiday-specific times (e.g., Yom Kippur) or fast day times, which would be expected for a comprehensive zmanim server.
Maintenance
Related MCP Connectors
A simple MCP server built with FastMCP and python
A MCP server built for developers enabling Git based project management with project and personal…
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
MCP server for Pinchwork - an agent-to-agent task marketplace with credits-based economy
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides powerful search capabilities for Jewish texts and literature. This server enables Large Language Models to search and reference Jewish texts through a standardized interface.23MIT
- AlicenseAqualityDmaintenanceA MCP server that provides timezone-aware date and time operations. This server addresses the common issue where AI assistants provide incorrect date information due to timezone confusion.45MIT
- FlicenseNot gradedqualityDmaintenanceA basic educational MCP server that provides simple tools for mathematical calculations, text manipulation, and time retrieval. Designed for learning MCP implementation patterns and development purposes.-

hebcal-mcpofficial
AlicenseAqualityFmaintenanceMCP server for Hebcal, enabling users to generate Jewish holiday lists, convert Hebrew dates, look up Shabbat candle lighting times, Torah readings, and yahrzeits.7103 npm6BSD 2-Clause "Simplified"