Hebcal

Provides a server for Jewish holidays, Hebrew date conversion, Shabbat times, Torah readings, and yahrzeit lookups via MCP

javascript

4

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months 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

You can run Hebcal MCP Server to generate Jewish holidays, Hebrew dates, Shabbat candle times, Torah readings, and yahrzeits data for users or apps. It offers two transport methods: a local stdio mode for direct CLI use and a server mode over HTTP using Server-Sent Events so clients can subscribe to updates. Use the HTTP mode for remote access and the stdio mode for embedded CLI workflows.

How to use

You can interact with the Hebcal MCP Server by choosing one of two transport methods. In HTTP mode, you start a server that streams messages to clients over SSE at a configurable port. In stdio mode, you run the server locally and talk to it through standard input and output. Your client can request holiday lists for any year, convert Hebrew dates, fetch Shabbat candle times, access Torah readings, and look up yahrzeits, birthdays, and anniversaries.

How to install

npm install
npm run build
node build/cli.js
```} ,{

Additional notes

# Start the HTTP SSE server (default port 8080)
NODE_PORT=8080 node build/server.js

Available tools

holidays

Generates a list of Jewish holidays for a specified year (past, present, or future) along with relevant observances.

dateConverter

Converts between Hebrew calendar dates and Gregorian dates.

shabbatTimes

Provides Shabbat candle lighting times.

torahReadings

Fetches Torah readings, including full kriyah and triennial system options.

yahrzeitsLookup

Looks up yahrzeits, birthdays, and anniversaries.