Hebcal (Jewish Calendar)

by hebcal

2 stars
Not rated
GitHub

About

Integrates with Hebrew calendar libraries to provide date conversions, yahrzeit calculations, and Torah portion information for Jewish religious observances.

Details

Author
hebcal
Repository
hebcal/hebcal-mcp
GitHub stars
2
License
BSD 2-Clause "Simplified" License
Categories
Design, Developer Tools, AI, Infrastructure, Knowledge Base

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Hebcal (Jewish Calendar)
    Command (node, npx, python, etc.) node
    Arguments
    • Argument 1 build/server.js
    Environment
    • NODE_PORT 3000

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

This MCP server can run in two modes:

1. Stdio Mode (default): Communicates over standard input/output.

    npm install
npm run build
node build/cli.js

2. Server-Sent Events (SSE) Mode: Communicates over HTTP using SSE.

    npm install
npm run build
node build/server.js

The SSE endpoint will be available at http://localhost:8080/mcp by default. You can configure the port using the NODE_PORT environment variable (e.g., NODE_PORT=3000 node build/server.js).

You can test the SSE endpoint with curl:

    curl -N http://localhost:8080/mcp

Then, in a separate terminal, you can send MCP requests (as JSON) to the server via its stdin if you are also running it in stdio mode, or by sending HTTP POST requests if you were to implement an HTTP ingress for requests. For now, the SSE transport only handles outgoing messages. For a full duplex SSE communication, the client would also need to send requests to the server (e.g. via POST requests to a different endpoint). This example focuses on the server sending events to the client.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "hebcal (jewish calendar)": {
            "env": {
                "NODE_PORT": "3000"
            },
            "args": [
                "build/server.js"
            ],
            "command": "node"
        }
    }
}

Linux

{
    "env": {
        "NODE_PORT": "3000"
    },
    "args": [
        "build/server.js"
    ],
    "command": "node"
}

Macos

{
    "env": {
        "NODE_PORT": "3000"
    },
    "args": [
        "build/server.js"
    ],
    "command": "node"
}

Windows

{
    "env": {
        "NODE_PORT": "3000"
    },
    "args": [
        "/c",
        "node",
        "build/server.js"
    ],
    "command": "cmd"
}

Hebcal Jewish holidays and Hebrew calednar Model Context Protocol (MCP) server

Hebcal (pronounced HEEB-kal, as in Hebrew calendar) is a free Jewish calendar and holiday web site.

Our mission is to increase awareness of Jewish holidays and to help Jews to be observant of the mitzvot.

This repository is the MCP server equivalent of the powerful custom Jewish calendar tool that lets you generate a list of Jewish holidays for any year (past, present or future).

Also available are a Hebrew date converterShabbat candle lighting times and Torah readings (both full kriyah and triennial system), and a page to look up yahrzeits, birthdays and anniversaries.

Running the Server

This MCP server can run in two modes:

1. Stdio Mode (default): Communicates over standard input/output.

    npm install
npm run build
node build/cli.js

2. Server-Sent Events (SSE) Mode: Communicates over HTTP using SSE.

    npm install
npm run build
node build/server.js

The SSE endpoint will be available at http://localhost:8080/mcp by default. You can configure the port using the NODE_PORT environment variable (e.g., NODE_PORT=3000 node build/server.js).

You can test the SSE endpoint with curl:

    curl -N http://localhost:8080/mcp

Then, in a separate terminal, you can send MCP requests (as JSON) to the server via its stdin if you are also running it in stdio mode, or by sending HTTP POST requests if you were to implement an HTTP ingress for requests. For now, the SSE transport only handles outgoing messages. For a full duplex SSE communication, the client would also need to send requests to the server (e.g. via POST requests to a different endpoint). This example focuses on the server sending events to the client.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.