Zmanim MCP Server

Zmanim MCP Server

<!-- mcp-name: io.github.ariroffe72/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.

Features

Available Tools

1. zmanimgetsunrisesunset** - Get sunrise and sunset times
2. zmanimgetshematimes** - Get latest times for reciting the morning Shema (GR"A and MG"A opinions)
3. zmanimgettefilatimes** - Get latest times for morning prayer/Shacharis (GR"A and MG"A opinions)
4. zmanimgetminchatimes** - Get times for afternoon prayer including Mincha Gedola, Mincha Ketana, and Plag HaMincha
5. zmanimgetshabbattimes** - Get Shabbat candle lighting and Havdalah times
6. zmanimgetdailytimes** - 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-server

Claude Desktop Configuration

Add to your claudedesktopconfig.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

Shortened. The full README is on GitHub.