Skip to main content
Glama
Lunar Calendar MCP Server

Lunar Calendar MCP Server

lunar-mcp — Chinese lunar calendar + BaZi MCP server

An MCP server for lunar calendar operations and BaZi calculations. Solar↔lunar conversion, auspicious day guidance, 24 Solar Terms, Five Elements analysis — all accessible to any MCP-compatible agent.

OpenClaw Skill

Overview

lunar-mcp is a Model Context Protocol server that exposes Chinese lunar calendar and BaZi (Four Pillars) tools to AI agents. It handles solar-to-lunar and lunar-to-solar date conversion, generates Huang Li (auspicious day) guidance, calculates BaZi charts, tracks the 24 Solar Terms (節氣), and analyzes Five Elements composition. Based on AlbertHuangKSFO/lunar_mcp_server (MIT).

Related MCP server: China Festival MCP Server

Features

  • BaZi calculation — Four Pillars from birth date

  • Date conversion — solar ↔ lunar calendar

  • Huang Li — auspicious and inauspicious day guidance

  • Daily fortune — daily luck overview

  • 24 Solar Terms — 節氣 tracking

  • Five Elements — Ngũ Hành composition analysis

  • MCP protocol — works with any MCP-compatible agent

Usage / Quick Start

pip install lunar-python
# then connect via MCP protocol

Trigger Keywords (OpenClaw)

lịch âm, âm lịch, lunar calendar, hoàng lịch, tiết khí, solar terms, ngũ hành, five elements, bazi calculation, 农历, 黄历


Part of the NachaFromMars OpenClaw skill ecosystem.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables traditional Chinese fortune-telling through BaZi (Four Pillars) analysis, including solar/lunar date conversion, Five Element balance calculations, Ten Gods deduction, and destiny interpretation for metaphysics applications.
      22 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides Chinese holiday information, lunar calendar conversion, traditional festivals, 24 solar terms, and BaZi (Eight Characters) calculations for AI assistants to accurately handle Chinese calendar queries and date conversions.
      3
      Apache 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides Chinese traditional calendar functions including BaZi calculation, solar-lunar calendar conversion, Huangli almanac queries, daily fortune readings, 24 solar terms, and Wu Xing (Five Elements) analysis.
      25 PyPI
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to perform Chinese metaphysics calculations including BaZi charts, Tong Shu indicators, solar terms, and more, using a verified engine with 740+ tests.
      8
      8
      MIT