Zmanim

Provides paleontological? No. Calculates Jewish prayer times worldwide using the python-zmanim library with multiple halachic opinions.

python

1

GitHub Stars

python

Language

2 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "ariroffe72-zmanim-mcp-server": {
      "command": "uvx",
      "args": [
        "zmanim-mcp-server"
      ]
    }
  }
}

You can run a dedicated MCP server that computes Jewish prayer times and related zmanim globally, powered by the python-zmanim library. This server exposes time calculations for sunrise, Shema, tefila, Mincha, Shabbat, and daily schedules, and it integrates with MCP clients to deliver precise, timezone-aware results for any location.

How to use

To use this MCP server, you run it through an MCP client and request the specific zmanim data you need. You can obtain sunrise/sunset, latest Shema times, Shacharis times, Mincha times, Shabbat times, or a complete daily zmanim set. Results can be returned in a machine-friendly JSON format or a human-friendly Markdown format, and calculations respect different halachic opinions and time zones.

How to install

Prerequisites: you need Python and an MCP client environment. You will also need the MCP client tool you plan to use (for example, uvx). Follow these steps to install and run the MCP server.

# Install the MCP client tooling (example: uvx)
# The actual command may vary depending on your environment
# This example assumes you will run the MCP server via uvx as shown in the usage snippet
uvx zmanim-mcp-server

Claude Desktop configuration

If you want to connect via Claude Desktop, add the MCP server configuration to your Claude Desktop configuration file as shown.

{
  "mcpServers": {
    "zmanim": {
      "command": "uvx",
      "args": ["zmanim-mcp-server"]
    }
  }
}

Available tools

zmanim_get_sunrise_sunset

Retrieve sunrise and sunset times for a given location, date, and timezone.

zmanim_get_shema_times

Compute the latest times for reciting the morning Shema according to GR"A and MG"A opinions.

zmanim_get_tefila_times

Provide the latest times for morning prayer (Shacharis) according to GR"A and MG"A opinions.

zmanim_get_mincha_times

Calculate afternoon prayer times including Mincha Gedola, Mincha Ketana, and Plag HaMincha.

zmanim_get_shabbat_times

Return Shabbat candle lighting and Havdalah times.

zmanim_get_daily_times

Offer a comprehensive set of all daily zmanim for a location and date.