Skip to main content
Glama
Zmanim MCP Server

Zmanim MCP Server

by ariroffe72

Zmanim MCP Server

PyPI version Downloads MCP Registry License: MIT

GitHub Stars Last Commit

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

  1. zmanim_get_sunrise_sunset - Get sunrise and sunset times

  2. zmanim_get_shema_times - Get latest times for reciting the morning Shema (GR"A and MG"A opinions)

  3. zmanim_get_tefila_times - Get latest times for morning prayer/Shacharis (GR"A and MG"A opinions)

  4. zmanim_get_mincha_times - Get times for afternoon prayer including Mincha Gedola, Mincha Ketana, and Plag HaMincha

  5. zmanim_get_shabbat_times - Get Shabbat candle lighting and Havdalah times

  6. 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

# For use with Claude Desktop or other MCP clients
uvx zmanim-mcp-server

Claude 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_York

Get 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/Jerusalem

Get 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/London

Zmanim 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

  1. Check that the path in your configuration is correct

  2. Ensure Python and all dependencies are installed

  3. Verify the configuration file syntax is valid JSON

  4. 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 tools
zmanim_get_daily_timesA
Read-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_timesA
Read-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_timesA
Read-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_timesA
Read-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_sunsetA
Read-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_timesA
Read-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

    A3.9/5.0

    Scored across 6 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An 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.
      23
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A 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.
      4
      5
      MIT
    • A
      license
      A
      quality
      F
      maintenance
      MCP server for Hebcal, enabling users to generate Jewish holiday lists, convert Hebrew dates, look up Shabbat candle lighting times, Torah readings, and yahrzeits.
      7
      103 npm
      6
      BSD 2-Clause "Simplified"